Windows Opencl clCreateKernel()函数

Windows Opencl clCreateKernel()函数

Opencl Creating Kernel Objects

函数原型

cl_kernel clCreateKernel(cl_program   program,
						 const char   *kernel_name,
		     			 cl_int       *errcode_ret) 

program 是一个具有成功构建的可执行文件的程序对象。

kernel_name是程序中用__kernel限定符声明的函数名。

errcode_ret将返回适当的错误代码。如果errcode_ret为空，则不返回错误代码。

clCreateKernel返回一个有效的非零内核对象，如果成功创建内核对象，则errcode_ret设置为CL_SUCCESS。否则，它将返回一个空值，并在errcode_ret中返回以下错误值之一：

1. CL_INVALID_PROGRAM 如果程序不是有效的程序对象。
2. CL_INVALID_PROGRAM_EXECUTABLE 如果没有为程序成功构建可执行文件。
3. CL_INVALID_KERNEL_NAME 如果在程序中找不到内核名。
4. CL_INVALID_KERNEL_DEFINITION 如果由kernel_name 指定的_kernel function的函数定义（如参数的数目），则为其生成可执行程序的所有设备的参数类型都不相同。
5. CL_INVALID_VALUE 如果kernel_name为空。
6. CL_OUT_OF_HOST_MEMORY 如果在主机上分配OpenCL实现所需的资源失败。