cl_int clEnqueueReleaseEGLObjectsKHR(cl_command_queue command_queue,
const cl_mem *mem_objects,
const cl_event *event_wait_list,
command_queue - A valid command-queue.
num_objects - The number of memory objects to be acquired in mem_objects.
mem_objects - A pointer to a list of OpenCL memory objects that were created from EGL resources, within the context associated with command_queue.
num_events_in_wait_list - Number of events in event_wait_list.
event_wait_list - Specify events that need to complete before this particular command can be executed. If event_wait_list is NULL, then this particular command does not wait on any event to complete. If event_wait_list is NULL, num_events_in_wait_list must be 0. If event_wait_list is not NULL, the list of events pointed to by event_wait_list must be valid and num_events_in_wait_list must be greater than 0. The events specified in event_wait_list act as synchronization points.
event - Returns an event object that identifies this command and can be used to query or queue a wait for the command to complete. event can 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 command_queue.
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. If
num_objects is 0 and mem_objects is NULL the function does nothing and
CL_SUCCESS. Otherwise, it returns one of the following errors:
CL_INVALID_VALUEif num_objects is zero and mem_objects is not a NULL value or if num_objects > 0 and mem_objects is NULL.
CL_INVALID_MEM_OBJECTif memory objects in mem_objects are not valid OpenCL memory objects in the context associated with command_queue.
CL_INVALID_EGL_OBJECT_KHRif memory objects in mem_objects have not been created from EGL resources.
CL_INVALID_COMMAND_QUEUEif command_queue is not a valid command-queue.
CL_INVALID_EVENT_WAIT_LISTif event_wait_list is NULL and num_events_in_wait_list > 0, or event_wait_list is not NULL and num_events_in_wait_list is 0, or if event objects in event_wait_list are 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.
For more information, see the OpenCL Extension Specification at URL