Enqueues a marker command which waits for either a list of events to complete, or all previously enqueued commands to complete.
cl_int
clEnqueueMarkerWithWaitList
(
| cl_command_queue command_queue , |
cl_uint num_events_in_wait_list , | |
const cl_event *event_wait_list , | |
cl_event
*event
) |
command_queue
A valid host command-queue.
event_wait_list
num_events_in_wait_list
These functions specify events that need to complete before this particular command can be executed.
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. The context associated with events in
event_wait_list
and command_queue
must
be the same. The memory associated with event_wait_list
can be reused or freed after the function returns.
If event_wait_list
is NULL, then this
particular command waits until all previous enqueued commands to
command_queue
have completed.
event
Returns an event object that identifies this particular command.
Event objects are unique and can be used to identify this marker
command later on. 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. If the
event_wait_list
and the event
arguments are not NULL, the event
argument should not
refer to an element of the event_wait_list
array.
Enqueues a marker command which waits for either a list of events to complete,
or if the list is empty it waits for all commands previously enqueued in
command_queue
to complete before it completes. This command returns
an event which can be waited on, i.e. this event can be waited on to insure that all
events either in the event_wait_list
or all previously enqueued
commands, queued before this command to command_queue
, have completed.
Returns CL_SUCCESS if the function executed successfully. Otherwise, it returns one of the following errors:
command_queue
is not a valid host command-queue.
command_queue
and events in
event_wait_list
are not the same.
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.