C Specification

To replace the default command queue on a device, call the function

cl_int clSetDefaultDeviceCommandQueue(
    cl_context context,
    cl_device_id device,
    cl_command_queue command_queue);

Parameters

  • context is the OpenCL context used to create command_queue.

  • device is a valid OpenCL device associated with context.

  • command_queue specifies a command queue object which replaces the default device command queue

Description

clSetDefaultDeviceCommandQueue may be used to replace a default device command queue created with clCreateCommandQueueWithProperties and the CL_​QUEUE_​ON_​DEVICE_​DEFAULT flag.

clSetDefaultDeviceCommandQueue returns CL_​SUCCESS if the function is executed successfully. Otherwise, it returns one of the following errors:

  • CL_​INVALID_​CONTEXT if context is not a valid context.

  • CL_​INVALID_​DEVICE if device is not a valid device or is not associated with context.

  • CL_​INVALID_​COMMAND_​QUEUE if command_queue is not a valid command-queue for device.

  • CL_​OUT_​OF_​RESOURCES if there is a failure to allocate resources required by the OpenCL implementation on the device.

  • CL_​OUT_​OF_​HOST_​MEMORY if there is a failure to allocate resources required by the OpenCL implementation on the host.

See Also

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.

Copyright (c) 2014-2020 Khronos Group. This work is licensed under a Creative Commons Attribution 4.0 International License.