vkGetPhysicalDeviceQueueFamilyProperties
To query properties of queues available on a physical device, call:
void vkGetPhysicalDeviceQueueFamilyProperties(
VkPhysicalDevice physicalDevice,
uint32_t* pQueueFamilyPropertyCount,
VkQueueFamilyProperties* pQueueFamilyProperties);
physicalDevice
is the handle to the physical device whose properties will be queried.pQueueFamilyPropertyCount
is a pointer to an integer related to the number of queue families available or queried, as described below.pQueueFamilyProperties
is eitherNULL
or a pointer to an array of VkQueueFamilyProperties structures.
If pQueueFamilyProperties
is NULL
, then the number of queue families
available is returned in pQueueFamilyPropertyCount
.
Implementations must support at least one queue family.
Otherwise, pQueueFamilyPropertyCount
must point to a variable set by
the application to the number of elements in the
pQueueFamilyProperties
array, and on return the variable is
overwritten with the number of structures actually written to
pQueueFamilyProperties
.
If pQueueFamilyPropertyCount
is less than the number of queue families
available, at most pQueueFamilyPropertyCount
structures will be
written.
Valid Usage (Implicit)
VUID-vkGetPhysicalDeviceQueueFamilyProperties-physicalDevice-parameter
physicalDevice
must be a valid VkPhysicalDevice handle
VUID-vkGetPhysicalDeviceQueueFamilyProperties-pQueueFamilyPropertyCount-parameter
pQueueFamilyPropertyCount
must be a valid pointer to a uint32_t
value
VUID-vkGetPhysicalDeviceQueueFamilyProperties-pQueueFamilyProperties-parameter
If the value referenced by pQueueFamilyPropertyCount
is not 0
, and pQueueFamilyProperties
is not NULL
, pQueueFamilyProperties
must be a valid pointer to an array of pQueueFamilyPropertyCount
VkQueueFamilyProperties structures