Creates a program object for a context, and loads the information related to the built-in kernels into a program object.
cl_program clCreateProgramWithBuiltInKernels(cl_context context, cl_uint num_devices, const cl_device_id *device_list, const char *kernel_names, cl_int *errcode_ret)
Must be a valid OpenCL context.
The number of devices listed in
A pointer to a list of devices that are in
device_listmust be a non-NULL value. The built-in kernels are loaded for devices specified in this list.
The devices associated with the program object will be the list of devices specified by
device_list. The list of devices specified by
device_listmust be devices associated with
A semi-colon separated list of built-in kernel names.
Returns a valid non-zero program object and
errcode_ret is set to
CL_SUCCESS if the program object is created successfully.
Otherwise, it returns a NULL value with one of the following error values returned in
contextis not a valid context.
device_listis NULL or
kernel_namesis NULL or
kernel_namescontains a kernel name that is not supported by any of the devices in
CL_INVALID_DEVICEif devices listed in
device_listare not in the list of devices associated with
CL_OUT_OF_RESOURCESif there is a failure to allocate resources required by the OpenCL implementation on the device.
CL_OUT_OF_HOST_MEMORYif there is a failure to allocate resources required by the OpenCL implementation on the host.