VkQueueFamilyGlobalPriorityProperties(3)

# VkQueueFamilyGlobalPriorityProperties(3) Manual Page

## Name

VkQueueFamilyGlobalPriorityProperties - Return structure for queue family global priority information query

## C Specification

The VkQueueFamilyGlobalPriorityProperties structure is defined as:

    // Provided by VK_VERSION_1_4
    typedef struct VkQueueFamilyGlobalPriorityProperties {
        VkStructureType          sType;
        void*                    pNext;
        uint32_t                 priorityCount;
        VkQueueGlobalPriority    priorities[VK_MAX_GLOBAL_PRIORITY_SIZE];
    } VkQueueFamilyGlobalPriorityProperties;

    // Provided by VK_KHR_global_priority
    // Equivalent to VkQueueFamilyGlobalPriorityProperties
    typedef VkQueueFamilyGlobalPriorityProperties VkQueueFamilyGlobalPriorityPropertiesKHR;

    // Provided by VK_EXT_global_priority_query
    // Equivalent to VkQueueFamilyGlobalPriorityProperties
    typedef VkQueueFamilyGlobalPriorityProperties VkQueueFamilyGlobalPriorityPropertiesEXT;

## Members

- `sType` is a VkStructureType value identifying this structure.

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

- `priorityCount` is the number of supported global queue priorities in this queue family, and it must be greater than 0.

- `priorities` is an array of VK_MAX_GLOBAL_PRIORITY_SIZE VkQueueGlobalPriority enums representing all supported global queue priorities in this queue family. The first `priorityCount` elements of the array will be valid.

## Description

If the `VkQueueFamilyGlobalPriorityProperties` structure is included in the `pNext` chain of the VkQueueFamilyProperties2 structure passed to vkGetPhysicalDeviceQueueFamilyProperties2, it is filled in with the list of supported global queue priorities for the indicated family.

The valid elements of `priorities` must not contain any duplicate values.

The valid elements of `priorities` must be a continuous sequence of VkQueueGlobalPriority enums in ascending order.

Note | For example, returning `priorityCount` as 3 with supported `priorities` as VK_QUEUE_GLOBAL_PRIORITY_LOW, VK_QUEUE_GLOBAL_PRIORITY_MEDIUM and VK_QUEUE_GLOBAL_PRIORITY_REALTIME is not allowed.

Valid Usage (Implicit)

- VUID-VkQueueFamilyGlobalPriorityProperties-sType-sType
  `sType` must be VK_STRUCTURE_TYPE_QUEUE_FAMILY_GLOBAL_PRIORITY_PROPERTIES

Structure Chaining

Extends the structure

  - VkQueueFamilyProperties2

## See Also

VK_EXT_global_priority_query, VK_KHR_global_priority, VK_VERSION_1_4, VkQueueGlobalPriority, 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-2026 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0