To enable or disable the properties of a command-queue, call the function
cl_int clSetCommandQueueProperty( cl_command_queue command_queue, cl_command_queue_properties properties, cl_bool enable, cl_command_queue_properties* old_properties);
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.
CL_SUCCESS if the function is executed
Otherwise, it returns one of the following errors:
CL_INVALID_COMMAND_QUEUEif command_queue is not a valid command-queue.
CL_INVALID_VALUEif values specified in properties are not valid.
CL_INVALID_QUEUE_PROPERTIESif values specified in properties are valid but are not supported by the device.
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.
Copyright (c) 2014-2020 Khronos Group. This work is licensed under a Creative Commons Attribution 4.0 International License.