VkDeviceQueueGlobalPriorityCreateInfoKHR(3)

# VkDeviceQueueGlobalPriorityCreateInfoKHR(3) Manual Page

## Name

VkDeviceQueueGlobalPriorityCreateInfoKHR - Specify a system wide priority

Loading… please wait.

## C Specification

Queues can be created with a system-wide priority by adding a `VkDeviceQueueGlobalPriorityCreateInfoKHR` structure to the `pNext` chain of VkDeviceQueueCreateInfo.

The `VkDeviceQueueGlobalPriorityCreateInfoKHR` structure is defined as:

    // Provided by VK_KHR_global_priority
    typedef struct VkDeviceQueueGlobalPriorityCreateInfoKHR {
        VkStructureType             sType;
        const void*                 pNext;
        VkQueueGlobalPriorityKHR    globalPriority;
    } VkDeviceQueueGlobalPriorityCreateInfoKHR;

or the equivalent

    // Provided by VK_EXT_global_priority
    typedef VkDeviceQueueGlobalPriorityCreateInfoKHR VkDeviceQueueGlobalPriorityCreateInfoEXT;

## Members

- `sType` is the type of this structure.

- `pNext` is `NULL` or a pointer to a structure extending this structure.

- `globalPriority` is the system-wide priority associated to these queues as specified by VkQueueGlobalPriorityEXT

## Description

Queues created without specifying `VkDeviceQueueGlobalPriorityCreateInfoKHR` will default to `VK_QUEUE_GLOBAL_PRIORITY_MEDIUM_KHR`.

Valid Usage (Implicit)

- VUID-VkDeviceQueueGlobalPriorityCreateInfoKHR-sType-sType
  `sType` must be `VK_STRUCTURE_TYPE_DEVICE_QUEUE_GLOBAL_PRIORITY_CREATE_INFO_KHR`

- VUID-VkDeviceQueueGlobalPriorityCreateInfoKHR-globalPriority-parameter
  `globalPriority` must be a valid VkQueueGlobalPriorityKHR value

## See Also

VK_EXT_global_priority, VK_KHR_global_priority, VkQueueGlobalPriorityKHR, VkStructureType

## 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-2022 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0