OpenCL编程步骤（六）：执行内核

  
  

   
   

    
    cl_int clEnqueueNDRangeKernel (
   
   
   
   

    
                                cl_command_queue command_queue,
   
   
   
   

    
                                cl_kernel kernel,
   
   
   
   

    
                                cl_uint work_dim,
   
   
   
   

    
                                const size_t *global_work_offset,
   
   
   
   

    
                                const size_t *global_work_size,
   
   
   
   

    
                                const size_t *local_work_size,
   
   
   
   

    
                                cl_uint num_events_in_wait_size,
   
   
   
   

    
                                const cl_event *event_wait_list,
   
   
   
   

    
                                cl_event *event)
   
   
  
  

此函数所入队的命令可以在设备上执行内核。

• command_queue是一个命令队列。排队的内核会在command_queue所关联的设备上执行。
• kernel是一个内核对象。kernel和command_queue必须在同一OpenCL上下文中。
• work_dim用来指定全局作业项以及作业项中的维数。其值必须大于0并且小于等于CL_DEVICE_MAX_WORK_ITEM_DIMENSIONS.
• global_work_offset是一个序列，有work_dim个元素，且元素为无符号值；所描述的偏移量可以用来计算作业项的全局ID。
• global_work_size也是一个序列，有work_dim个元素，且元素为无符号值；对于将要执行kernel的全局作业项而言，它在某个维度上的数目由序列中的相应元素表示。
• local_work_size也是一个序列，有work_dim个元素，且元素为无符号值；对于将要执行kernel的作业项而言，其中作业项的数目由序列中的相应元素表示。   local_work_size也可以是NULL，这样的话OpenCL操作将自己决定如何将全局作业项分割成多个作业项实体。这些作业项实体将在多个计算单元中并行执行。每个作业项都有一个惟一的全局ID。在内核中，可以通过global_work_size和global_work_offset的运算得到这个全局ID。另外，每个作业项在作业组中还有一个惟一的局部ID。在内核中，可以通过对local_work_size的运算得到这个局部ID。局部ID始终起自(0,0,0,...,0)。
• event_wait_list和num_events_in_wait_list中列出了执行此命令前要等待的事件。如果event_wait_list是NULL，则无须等待任何事件，并且num_events_in_wait_list必须是0。如果event_wait_list不是NULL，则其中的事件充当同步点，并且必须与command_queue位于同一个上下文中。此函数返回后，就可以回收和重新使用event_wait_list所关联的设备。 
• event会返回一个事件对象，用来标志此读写命令，可以用来查询或等待此命令完成。如果event是NULL，就没有办法查询此命令的状态或等待其完成了。如果event_wait_list和event都不是NULL，event不能属于event_wait_list。