Acquire OpenCL memory objects that have been created from EGL resources.
cl_int clEnqueueAcquireEGLObjectsKHR(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 associate 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 acquire OpenCL memory objects that have been created from EGL resources.
The EGL objects are acquired by the OpenCL context associated with
command_queue and can therefore be used by all command-queues associated with the OpenCL context.
OpenCL memory objects created from EGL resources must be acquired before they can be used by any OpenCL commands queued to a command-queue.
If an OpenCL memory object created from a EGL resource is used while it is not currently acquired by OpenCL, the call attempting to use that OpenCL memory object will return
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.