kernel
Specifies the kernel object being queried.
param_name
Specifies the information to query. The list of supported
param_name
types and the information returned in
param_value
by clGetKernelInfo
is described in the table below.
param_value
A pointer to memory where the appropriate result being queried is returned.
If param_value
is NULL, it is ignored.
param_value_size
Used to specify the size in bytes of memory pointed to
by param_value
.
This size must be ≥ size of return
type as described in the table below.
cl_kernel_info | Return Type | Info. returned in param_value |
---|---|---|
CL_KERNEL_FUNCTION_NAME
|
char[] | Return the kernel function name. |
CL_KERNEL_NUM_ARGS
|
cl_uint |
Return the number of arguments to kernel .
|
CL_KERNEL_REFERENCE_COUNT
|
cl_uint |
Return the The reference count returned should be considered immediately stale. It is unsuitable for general use in applications. This feature is provided for identifying memory leaks. |
CL_KERNEL_CONTEXT
|
cl_context |
Return the context associated with kernel .
|
CL_KERNEL_PROGRAM
|
cl_program |
Return the program object associated with kernel .
|
CL_KERNEL_ATTRIBUTES
|
char[] |
Returns any attributes specified using the __attribute__ qualifier with the kernel function declaration in the program source. These attributes include those on the __attribute__ page and other attributes supported by an implementation. Attributes are returned as they were declared inside __attribute__((...)), with any surrounding whitespace and embedded newlines removed. When multiple attributes are present, they are returned as a single, space delimited string. |
param_value_size_ret
the actual size in bytes of data copied to param_value
.
If param_value_size_ret
is NULL, it is ignored.
Returns CL_SUCCESS if the function is executed successfully. Otherwise, it returns one of the following errors:
param_name
is not
valid, or if size in bytes specified by param_value_size
is < size of return type as described in the table above and
param_value
is not NULL.
kernel
is not a valid kernel object.
clCreateKernel, clCreateKernelsInProgram, clGetKernelArgInfo, clRetainKernel, clReleaseKernel, clSetKernelArg, clGetKernelWorkGroupInfo