Release OpenCL memory objects that have been created from EGL resources.
cl_int clEnqueueReleaseEGLObjectsKHR(cl_command_queue command_queue, cl_uint num_objects, const cl_mem *mem_objects, cl_uint num_events_in_wait_list, const cl_event *event_wait_list, cl_event *event)
A valid command-queue.
The number of memory objects to be acquired in
A pointer to a list of OpenCL memory objects that were created from EGL resources, within the context associated with
Specify events that need to complete before this particular command can be executed. If
event_wait_listis NULL, then this particular command does not wait on any event to complete. If
num_events_in_wait_listmust be 0. If
event_wait_listis not NULL, the list of events pointed to by
event_wait_listmust be valid and
num_events_in_wait_listmust be greater than 0. The events specified in
event_wait_listact as synchronization points.
Returns an event object that identifies this command and can be used to query or queue a wait for the command to complete.
eventcan be NULL in which case it will not be possible for the application to query the status of this command or queue a wait for this command to complete.
This function is used to release OpenCL memory objects that have been created from EGL resources.
The EGL objects are released by the OpenCL context associated with
OpenCL memory objects created from EGL resources which have been acquired by OpenCL must be released by OpenCL before they may be accessed by EGL or by EGL client APIs.
Accessing a EGL resource while its corresponding OpenCL memory object is acquired is in error and will result in undefined behavior, including but not limited to possible OpenCL errors, data corruption, and program termination.
CL_SUCCESS if the function is executed successfully.
num_objects is 0 and
mem_objects is NULL the function does nothing and returns
Otherwise, it returns one of the following errors:
num_objectsis zero and
mem_objectsis not a NULL value or if
num_objects> 0 and
CL_INVALID_MEM_OBJECTif memory objects in
mem_objectsare not valid OpenCL memory objects in the context associated with
CL_INVALID_EGL_OBJECT_KHRif memory objects in
mem_objectshave not been created from EGL resources.
command_queueis not a valid command-queue.
event_wait_listis NULL and
num_events_in_wait_list> 0, or
event_wait_listis not NULL and
num_events_in_wait_listis 0, or if event objects in
event_wait_listare not valid events.
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.