VkQueueGlobalPriorityKHR(3)

# VkQueueGlobalPriorityKHR(3) Manual Page

## Name

VkQueueGlobalPriorityKHR - Values specifying a system-wide queue priority

Loading… please wait.

## C Specification

Possible values of VkDeviceQueueGlobalPriorityCreateInfoKHR::`globalPriority`, specifying a system-wide priority level are:

    // Provided by VK_KHR_global_priority
    typedef enum VkQueueGlobalPriorityKHR {
        VK_QUEUE_GLOBAL_PRIORITY_LOW_KHR = 128,
        VK_QUEUE_GLOBAL_PRIORITY_MEDIUM_KHR = 256,
        VK_QUEUE_GLOBAL_PRIORITY_HIGH_KHR = 512,
        VK_QUEUE_GLOBAL_PRIORITY_REALTIME_KHR = 1024,
        VK_QUEUE_GLOBAL_PRIORITY_LOW_EXT = VK_QUEUE_GLOBAL_PRIORITY_LOW_KHR,
        VK_QUEUE_GLOBAL_PRIORITY_MEDIUM_EXT = VK_QUEUE_GLOBAL_PRIORITY_MEDIUM_KHR,
        VK_QUEUE_GLOBAL_PRIORITY_HIGH_EXT = VK_QUEUE_GLOBAL_PRIORITY_HIGH_KHR,
        VK_QUEUE_GLOBAL_PRIORITY_REALTIME_EXT = VK_QUEUE_GLOBAL_PRIORITY_REALTIME_KHR,
    } VkQueueGlobalPriorityKHR;

or the equivalent

    // Provided by VK_EXT_global_priority
    typedef VkQueueGlobalPriorityKHR VkQueueGlobalPriorityEXT;

## Description

Priority values are sorted in ascending order. A comparison operation on the enum values can be used to determine the priority order.

- `VK_QUEUE_GLOBAL_PRIORITY_LOW_KHR` is below the system default. Useful for non-interactive tasks.

- `VK_QUEUE_GLOBAL_PRIORITY_MEDIUM_KHR` is the system default priority.

- `VK_QUEUE_GLOBAL_PRIORITY_HIGH_KHR` is above the system default.

- `VK_QUEUE_GLOBAL_PRIORITY_REALTIME_KHR` is the highest priority. Useful for critical tasks.

## See Also

VK_EXT_global_priority, VK_KHR_global_priority, VkDeviceQueueGlobalPriorityCreateInfoKHR, VkQueueFamilyGlobalPriorityPropertiesKHR

## Document Notes

For more information, see the Vulkan Specification

This page is extracted from the Vulkan Specification. Fixes and changes should be made to the Specification, not directly.

## Copyright

Copyright 2014-2024 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0