C Specification
To wait for events to complete, call the function
// Provided by CL_VERSION_1_0
cl_int clWaitForEvents(
cl_uint num_events,
const cl_event* event_list);
Parameters
-
num_events is the number of events in event_list.
-
event_list is a pointer to a list of event object handles.
Description
This function waits on the host thread for commands identified by event
objects in event_list to complete.
A command is considered complete if its execution status is CL_COMPLETE
or a
negative value.
The events specified in event_list act as synchronization points.
clWaitForEvents returns CL_SUCCESS
if the execution status of all events
in event_list is CL_COMPLETE
.
Otherwise, it returns one of the following errors:
-
CL_INVALID_
if num_events is zero or event_list isVALUE NULL
. -
CL_INVALID_
if events specified in event_list do not belong to the same context.CONTEXT -
CL_INVALID_
if event objects specified in event_list are not valid event objects.EVENT -
CL_EXEC_
if the execution status of any of the events in event_list is a negative integer value. This error code is missing before version 1.1.STATUS_ ERROR_ FOR_ EVENTS_ IN_ WAIT_ LIST -
CL_OUT_
if there is a failure to allocate resources required by the OpenCL implementation on the device.OF_ RESOURCES -
CL_OUT_
if there is a failure to allocate resources required by the OpenCL implementation on the host.OF_ HOST_ MEMORY
Document Notes
For more information, see the OpenCL Specification
This page is extracted from the OpenCL Specification. Fixes and changes should be made to the Specification, not directly.