vkGetPhysicalDeviceQueueFamilyPerformanceQueryPassesKHR(3)

# vkGetPhysicalDeviceQueueFamilyPerformanceQueryPassesKHR(3) Manual Page

## Name

vkGetPhysicalDeviceQueueFamilyPerformanceQueryPassesKHR - Reports the number of passes require for a performance query pool type

## C Specification

To query the number of passes required to query a performance query pool on a physical device, call:

    void vkGetPhysicalDeviceQueueFamilyPerformanceQueryPassesKHR(
        VkPhysicalDevice                            physicalDevice,
        const VkQueryPoolPerformanceCreateInfoKHR*  pPerformanceQueryCreateInfo,
        uint32_t*                                   pNumPasses);

## Parameters

- `physicalDevice` is the handle to the physical device whose queue family performance query counter properties will be queried

- `pPerformanceQueryCreateInfo` is a pointer to an `VkQueryPoolPerformanceCreateInfoKHR` of the performance query that is to be created

- `pNumPasses` is a pointer to an integer related to the number of passes required to query the performance query pool, as described below

## Description

The `pPerformanceQueryCreateInfo` member `VkQueryPoolPerformanceCreateInfoKHR`::`queueFamilyIndex` must be a queue family of `physicalDevice`. The number of passes required to capture the counters specified in the `pPerformanceQueryCreateInfo` member `VkQueryPoolPerformanceCreateInfoKHR`::`pCounters` is returned in `pNumPasses`.

Valid Usage (Implicit)

- `physicalDevice` must be a valid `VkPhysicalDevice` handle

- `pPerformanceQueryCreateInfo` must be a valid pointer to a valid `VkQueryPoolPerformanceCreateInfoKHR` structure

- `pNumPasses` must be a valid pointer to a `uint32_t` value

## See Also

VkPhysicalDevice, VkQueryPoolPerformanceCreateInfoKHR

## 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 (c) 2014-2019 Khronos Group. This work is licensed under a Creative Commons Attribution 4.0 International License.