Function Prototype

vkGetPhysicalDeviceToolProperties

Reports properties of tools active on the specified physical device

Information about tools providing debugging, profiling, or similar services, active for a given physical device, can be obtained by calling:

VkResult vkGetPhysicalDeviceToolPropertiesEXT(
    VkPhysicalDevice physicalDevice,
    uint32_t* pToolCount,
    VkPhysicalDeviceToolProperties* pToolProperties);
  • physicalDevice is the handle to the physical device to query for active tools.
  • pToolCount is a pointer to an integer describing the number of tools active on physicalDevice.
  • pToolProperties is either NULL or a pointer to an array of VkPhysicalDeviceToolProperties structures.

If pToolProperties is NULL, then the number of tools currently active on physicalDevice is returned in pToolCount. Otherwise, pToolCount must point to a variable set by the application to the number of elements in the pToolProperties array, and on return the variable is overwritten with the number of structures actually written to pToolProperties. If pToolCount is less than the number of currently active tools, at most pToolCount structures will be written.

The count and properties of active tools may change in response to events outside the scope of the specification. An application should assume these properties might change at any given time.

Valid Usage (Implicit)

VUID-vkGetPhysicalDeviceToolProperties-pToolCount-parameter

pToolCount must be a valid pointer to a uint32_t value

VUID-vkGetPhysicalDeviceToolProperties-pToolProperties-parameter

If the value referenced by pToolCount is not 0, and pToolProperties is not NULL, pToolProperties must be a valid pointer to an array of pToolCount VkPhysicalDeviceToolProperties structures