C Specification
To create a user event object, call the function
// Provided by CL_VERSION_1_1
cl_event clCreateUserEvent(
cl_context context,
cl_int* errcode_ret);
clCreateUserEvent is missing before version 1.1. |
Parameters
-
context must be a valid OpenCL context.
-
errcode_ret will return an appropriate error code. If errcode_ret is
NULL
, no error code is returned.
Description
User events allow applications to enqueue commands that wait on a user event to finish before the command is executed by the device.
clCreateUserEvent returns a valid non-zero event object and errcode_ret
is set to CL_SUCCESS
if the user event object is created successfully.
Otherwise, it returns a NULL
value with one of the following error values
returned in errcode_ret:
-
CL_INVALID_
if context is not a valid context.CONTEXT -
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
The initial execution status for the user event object is CL_SUBMITTED
.
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.