Command Queue - Extensions

oneAPI Level Zero Specification - Version 1.18.31

Command Queue - Extension Functions

zeCommandQueueSetPriorityExt

Added in version 1.18

ZE_APIEXPORT ze_result_t ZE_APICALL zeCommandQueueSetPriorityExt(ze_command_queue_handle_t hCommandQueue, ze_command_queue_priority_t priority)

Sets the priority of a command queue.

• The application may call this function from simultaneous threads.

• This function changes the priority of an existing command queue, overriding the priority specified at creation through ze_command_queue_desc_t; the updated value is reported by zeCommandQueueGetPriority.

• Whether the new priority affects commands already submitted to the command queue, or only commands submitted after this call, is implementation-defined.

Parameters:

• hCommandQueue – [in] handle of the command queue

• priority – [in] priority to set for the command queue

Returns:

• ZE_RESULT_SUCCESS

• ZE_RESULT_ERROR_UNINITIALIZED

• ZE_RESULT_ERROR_DEVICE_LOST

• ZE_RESULT_ERROR_OUT_OF_HOST_MEMORY

• ZE_RESULT_ERROR_OUT_OF_DEVICE_MEMORY

• ZE_RESULT_ERROR_INVALID_ARGUMENT

• ZE_RESULT_ERROR_UNSUPPORTED_FEATURE

• ZE_RESULT_ERROR_DEPENDENCY_UNAVAILABLE

• ZE_RESULT_ERROR_INSUFFICIENT_PERMISSIONS

• ZE_RESULT_ERROR_NOT_AVAILABLE

• ZE_RESULT_ERROR_DEVICE_REQUIRES_RESET

• ZE_RESULT_ERROR_DEVICE_IN_LOW_POWER_STATE

• ZE_RESULT_ERROR_UNKNOWN

• ZE_RESULT_ERROR_INVALID_NULL_HANDLE

  • nullptr == hCommandQueue

• ZE_RESULT_ERROR_INVALID_ENUMERATION

  • ZE_COMMAND_QUEUE_PRIORITY_PRIORITY_HIGH < priority

• ZE_RESULT_ERROR_UNSUPPORTED_ENUMERATION