vkGetPhysicalDeviceToolProperties
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 onphysicalDevice
.pToolProperties
is eitherNULL
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-physicalDevice-parameter
physicalDevice
must be a valid VkPhysicalDevice handle
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