To enable or disable the properties of a command-queue, call the function
|clSetCommandQueueProperty is deprecated by version 1.1.
command_queue specifies the command-queue being modified.
properties specifies the new list of properties for the command-queue. This is a bit-field and the supported properties are described in the Command-Queue Properties table for clCreateCommandQueue. Only command-queue properties specified in this table can be used, otherwise the value specified in properties is considered to be not valid.
enable determines whether the values specified by properties are enabled (if enable is
CL_TRUE) or disabled (if enable is
CL_FALSE) for the command-queue.
old_properties returns the command-queue properties before they were changed by clSetCommandQueueProperty. If old_properties is
NULL, it is ignored.
clSetCommandQueueProperty may unconditionally return an error if no devices in the context associated with command_queue support modifying the properties of a command-queue. Support for modifying the properties of a command-queue is required only for OpenCL 1.0 devices.
CL_SUCCESS if the function is executed
Otherwise, it returns one of the following errors:
CL_INVALID_if command_queue is not a valid command-queue.
CL_INVALID_if no devices in the context associated with command_queue support modifying the properties of a command-queue.
CL_INVALID_if values specified in properties are not valid.
CL_INVALID_if values specified in properties are valid but are not supported by the device.
CL_OUT_if there is a failure to allocate resources required by the OpenCL implementation on the device.
CL_OUT_if there is a failure to allocate resources required by the OpenCL implementation on the host.
OF_ HOST_ MEMORY
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.