C Specification

If the pNext chain of VkDeviceObjectReservationCreateInfo includes a VkPerformanceQueryReservationInfoKHR structure, then the structure indicates upper bounds on the number of performance queries that can exist at the same time in a query pool.

The VkPerformanceQueryReservationInfoKHR structure is defined as:

// Provided by VKSC_VERSION_1_0 with VK_KHR_performance_query
typedef struct VkPerformanceQueryReservationInfoKHR {
    VkStructureType    sType;
    const void*        pNext;
    uint32_t           maxPerformanceQueriesPerPool;
} VkPerformanceQueryReservationInfoKHR;

Members

  • sType is a VkStructureType value identifying this structure.

  • pNext is NULL or a pointer to a structure extending this structure.

  • maxPerformanceQueriesPerPool is the requested maximum number of VK_QUERY_TYPE_PERFORMANCE_QUERY_KHR queries that can exist at the same time in a single query pool.

Description

If the VkDeviceObjectReservationCreateInfo::pNext chain does not include this structure, then maxPerformanceQueriesPerPool defaults to 0.

Multiple VkPerformanceQueryReservationInfoKHR structures can be chained together. The maximum value from all instances of maxPerformanceQueriesPerPool will be reserved.

Valid Usage (Implicit)

  • VUID-VkPerformanceQueryReservationInfoKHR-sType-sType
    sType must be VK_STRUCTURE_TYPE_PERFORMANCE_QUERY_RESERVATION_INFO_KHR

See Also

VKSC_VERSION_1_0, VK_KHR_performance_query, 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-2025 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0