OpenCL 缓冲区对象映射

除了可使用读/写函数在主机与设备间拷贝数据之外,OpenCL还提供了把设备上的存储器对象映射到主机可访问的内存区域。一旦映射确定后,可以在主机端通过指针读取或修改设备存储器对象的值。对于缓冲区对象和图像对象都可以映射。

缓冲区对象映射

可以使用如下函数来映射缓冲区对象到主机内存区域:

void *clEnqueueMapBuffer (cl_command_queue command_queue,
                              cl_mem buffer,
                              cl_bool blocking_map,
                              cl_map_flags map_flags,
                              size_t offset,
                              size_t size,
                              cl_uint num_events_in_wait_list,
                              const cl_event *event_wait_list,
                              cl_event *event,
                              cl_int *errcode_ret)
  • 参数command_queue为一个有效的主机命令队列。

  • 参数blocking_map表明此映射是阻塞的还是非阻塞的。如果blocking_map为CL_TRUE,即表示映射命令是阻塞的,直到映射完成,函数才会返回。应用可以用返回的指针访问所映射区域的内容;如果blocking_map为CL_FALSE,即映射为非阻塞的,直到映射命令完成后才能使用返回的指针。参数event会返回一个事件对象,可用来查询映射命令的执行情况。在完成映射后,应用才可以使用返回的指针访问映射区域的内容。

  • 参数map_f lags为位域,用于描述映射区域的状态。详细见下表。
    cl_map_flags支持列表

  • 参数offset和size为所要映射的区域在缓冲区对象中的偏移量和大小,单位为字节。其余参数与5.4.1节中同名参数意义一样,在此就不赘述。

函数clEnqueueMapBuffer实现把缓冲区对象映射到主机可访问的内存区域。//创建上下文和命令队列

buffer = clCreateBuffer(context,
CL_MEM_READ_WRITE | CL_MEM_ALLOC_HOST_PTR,
                            sizseof(float) * NUM_ELEMENTS, &err);
cl_float *inputData = (cl_float *)clEnqueueMapBuffer(cmdqueue,
                          buffer, CL_TRUE,
                          CL_MAP_WRTTE, 0, sizeof(float) * NUM_ELEMENTS,
                          0, NULL, NULL,
                          &err);
//对inputData写入操作
err = clEnqueueUnmapMemObject(cmdqueue, buffer, inputData, 0,
                                    NULL, NULL);
//执行内核
cl_float *outData = (cl_float *)clEnqueueMapBuffer(cmdqueue,
                        buffer, CL_TRUE,
                        CL_MAP_REA, 0, sizeof(float) * NUM_ELEMENTS, 0,
                        NULL, NULL,
                        &err);
//对outData操作
err = clEnqueueUnmapMemObject(cmdqueue, buffer, outData, 0, NULL,
                                    NULL);

在例子中,我们使用CL_MEM_READ_WRITE|CL_MEM_ALLOC_HOST_PTR属性来分配缓冲区对象。把分配好的缓冲区对象通过map()/unmap()来映射或解映射到主机,避免了数据在主机与设备间来回拷贝。分配示意图如下图所示。
利用clCreateBuffer(CL_MEM_ALLOC_HOST_PTR)创建存储器对象

OpenCL默认假设主机与GPU的内存是各自独立的,分配缓冲区将会牵涉数据拷贝问题。对于AMD APU设备或者ARM Mali设备,主机与GPU共享内存,如果采用在主机与设备上分配缓冲区,这显然是浪费时间和功耗的。我们可以使用如下代码来避免数据拷贝:

#define NUM_ELEMENTS 1000
cl_int err;
cl_context context;
cl_command_queue cmdqueue;
cl_mem buffer;

赞(0)
未经允许不得转载:极客笔记 » OpenCL 缓冲区对象映射

评论 抢沙发

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址
OpenCL 基本概念
OpenCL 是什么OpenCL 平台模型OpenCL 执行模型OpenCL 上下文简介OpenCL 命令队列简介OpenCL 在设备上执行内核OpenCL 存储器区域OpenCL 存储器对象OpenCL 共享虚拟存储器OpenCL 与OpenGL
OpenCL 基础教程
OpenCL 在Windows上搭建开发环境OpenCL 在Linux上搭建开发环境OpenCL 在OS X上搭建开发环境OpenCL 第一个程序OpenCL 平台OpenCL 设备OpenCL 创建上下文OpenCL 创建命令队列OpenCL 创建Program对象OpenCL 编译Program对象OpenCL 查询和管理Program对象OpenCL 创建内核对象OpenCL 设置内核参数OpenCL 查询和管理内核对象OpenCL 执行内核OpenCL 编写内核代码OpenCL 错误处理
OpenCL C特性
OpenCL 地址空间修饰符OpenCL 函数修饰符OpenCL 对象访问修饰符OpenCL 标量数据类型OpenCL 为什么要有矢量数据类型OpenCL 矢量初始化OpenCL 读取和修改矢量分量OpenCL 运算符OpenCL 维度和工作项OpenCL 工作组OpenCL 矢量数据拷贝OpenCL 异步拷贝和预取OpenCL 数学函数OpenCL 公共函数OpenCL 几何函数OpenCL 整数函数OpenCL 关系函数OpenCL 杂项矢量函数OpenCL 同步函数OpenCL 原子函数OpenCL 内建图像读函数OpenCL 内建无采样器图像读函数OpenCL 内建图像写函数OpenCL 内建图像查询函数OpenCL 工作组函数OpenCL 内建管道读/写函数OpenCL 内建工作组管道读/写函数OpenCL 内建管道查询函数OpenCL 设备队列OpenCL Blocks语法OpenCL 设备队列相关函数OpenCL 子内核存储器可见性OpenCL 设备队列的使用示例
OpenCL 存储器对象
OpenCL 存储器对象OpenCL 分配缓冲区对象OpenCL 创建子缓冲区对象OpenCL 图像对象和采样器对象OpenCL 图像对象OpenCL 图像格式描述符OpenCL 图像描述符OpenCL 图像对象查询OpenCL 采样器对象OpenCL 主机端采样器对象OpenCL 设备端采样器对象OpenCL 图像旋转示例OpenCL 管道OpenCL 创建管道对象OpenCL 管道对象查询OpenCL 主机与设备间数据传输OpenCL 图像对象主机与设备间数据拷贝OpenCL 缓冲区对象数据填充OpenCL 图像对象数据填充OpenCL 缓冲区对象间数据传输OpenCL 图像对象和缓冲区对象间数据拷贝OpenCL 缓冲区对象映射OpenCL 图像对象映射OpenCL 解映射OpenCL 共享虚拟存储器OpenCL SVM缓冲创建与释放OpenCL SVM缓冲映射与解映射OpenCL SVM缓冲填充与拷贝OpenCL SVM类型OpenCL SVM特性OpenCL 共享虚拟存储器示例OpenCL 存储器一致性模型OpenCL 存储器次序规则OpenCL 原子操作的存储器次序规则OpenCL 栅栏操作的存储器次序规则OpenCL 工作组函数的存储器次序规则OpenCL 主机端与设备端命令的存储器次序规则OpenCL 关于存储器次序在实际OpenCL计算设备中的实现
OpenCL 同步及事件机制
OpenCL 同步及事件机制OpenCL 主机端的OpenCL同步OpenCL OpenCL事件机制OpenCL 对OpenCL事件的标记和栅栏OpenCL 内核程序中的同步OpenCL 工作组内同步OpenCL 原子操作OpenCL 1.2中的原子操作OpenCL 2.0中的原子操作OpenCL 局部存储器与全局存储器间的异步拷贝OpenCL 工作组间同步
OpenCL 与OpenGL互操作
OpenCL 与OpenGL互操作OpenCL 从一个OpenGL上下文来创建OpenCL上下文OpenCL 使用OpenGL共享的缓存对象OpenCL 使用OpenGL纹理数据OpenCL 共享OpenGL渲染缓存OpenCL 从一个OpenCL存储器对象查询OpenGL对象信息OpenCL 访问共享对象的OpenCL与OpenGL之间的同步OpenCL AMD Cayman架构GPUOpenCL AMD GCN架构的GPUOpenCL NVIDIA CUDA兼容的GPUOpenCL NVIDIA GPU架构的执行模型OpenCL NVIDIA GPU的全局存储器OpenCL NVIDIA GPU的局部存储器OpenCL ARM Mali GPU硬件架构OpenCL ARM Mali GPU存储器层次OpenCL ARM Mali GPU OpenCL映射