The following table describes the list of built-in functions that can be used to enqueue commands such as a marker.
int enqueue_marker(queue_t queue, uint num_events_in_wait_list, const clk_event_t *event_wait_list, clk_event_t *event_ret)
Enqueue a marker command to queue.
The marker command waits for a list of events specified by event_wait_list to complete before the marker completes.
event_ret must not be
If an event is returned, enqueue_marker performs an implicit retain on the returned event.
The enqueue_marker built-in function returns
CLK_SUCCESS if the marked
command is enqueued successfully and returns
If the -g compile option is specified in compiler options passed to
clCompileProgram or clBuildProgram, the following errors may be returned
CLK_ENQUEUE_FAILURE to indicate why enqueue_marker failed to
enqueue the marker command:
CLK_INVALID_QUEUEif queue is not a valid device queue.
CLK_INVALID_EVENT_WAIT_LISTif event_wait_list is
NULL, or if event_wait_list is not
NULLand num_events_in_wait_list is 0, or if event objects in event_wait_list are not valid events.
CLK_DEVICE_QUEUE_FULLif queue is full.
CLK_EVENT_ALLOCATION_FAILUREif event_ret is not
NULLand an event could not be allocated.
CLK_OUT_OF_RESOURCESif there is a failure to queue the block in queue because of insufficient resources needed to execute the kernel.
For more information, see the OpenCL C Specification
This page is extracted from the OpenCL C Specification. Fixes and changes should be made to the Specification, not directly.