cl_int
clCreateKernelsInProgram
(
| cl_program program, |
cl_uint num_kernels, | |
cl_kernel *kernels, | |
cl_uint *num_kernels_ret) |
program
A program object with a successfully built executable.
num_kernels
The size of memory pointed to by
kernels
specified as the number of cl_kernel
entries.
kernels
The buffer where the kernel
objects for kernels in program
will be
returned. If kernels
is NULL, it is ignored. If
kernels
is not NULL, num_kernels
must be greater than or equal to the number of kernels in
program
.
num_kernels_ret
The number of kernels in
program
. If num_kernels_ret
is NULL,
it is ignored.
Creates kernel objects for all kernel functions in
program
. Kernel objects are not created for any __kernel
functions in program
that do not have the same function definition
across all devices for which a program executable has been successfully built.
Kernel objects can only be created once you have a program object with a
valid program source or binary loaded into the program object and the program
executable has been successfully built for one or more devices associated
with program. No changes to the program executable are allowed while there
are kernel objects associated with a program object. This means that calls to
clBuildProgram and
clCompileProgram return
CL_INVALID_OPERATION
if there are kernel objects attached
to a program object. The OpenCL context associated with program
will be the context associated with kernel
. The list of devices
associated with program
are the devices associated with kernel
.
Devices associated with a program object for which a valid program executable has
been built can be used to execute kernels declared in the program object.
Returns CL_SUCCESS if the kernel objects are successfully allocated. Otherwise, it returns one of the following errors:
program
is not
a valid program object.
program
.
kernels
is not
NULL and num_kernels
is less than the number of kernels in
program
.
clCreateKernel, clRetainKernel, clReleaseKernel, clSetKernelArg, clGetKernelInfo, clGetKernelWorkGroupInfo