VkDeviceQueueCreateInfo
The VkDeviceQueueCreateInfo
structure is defined as:
typedef struct VkDeviceQueueCreateInfo {
VkStructureType sType;
const void* pNext;
VkDeviceQueueCreateFlags flags;
uint32_t queueFamilyIndex;
uint32_t queueCount;
const float* pQueuePriorities;
} VkDeviceQueueCreateInfo;
sType
is a VkStructureType value identifying this structure.pNext
isNULL
or a pointer to a structure extending this structure.flags
is reserved for future use.queueFamilyIndex
is an unsigned integer indicating the index of the queue family in which to create the queues on this device. This index corresponds to the index of an element of thepQueueFamilyProperties
array that was returned byvkGetPhysicalDeviceQueueFamilyProperties
.queueCount
is an unsigned integer specifying the number of queues to create in the queue family indicated byqueueFamilyIndex
, and with the behavior specified byflags
.pQueuePriorities
is a pointer to an array ofqueueCount
normalized floating-point values, specifying priorities of work that will be submitted to each created queue. See Queue Priority for more information.
Valid Usage
VUID-VkDeviceQueueCreateInfo-queueFamilyIndex-00381
queueFamilyIndex
must be less than
pQueueFamilyPropertyCount
returned by
vkGetPhysicalDeviceQueueFamilyProperties
VUID-VkDeviceQueueCreateInfo-queueCount-00382
queueCount
must be less than or equal to the queueCount
member of the VkQueueFamilyProperties
structure, as returned by
vkGetPhysicalDeviceQueueFamilyProperties
in the
pQueueFamilyProperties
[queueFamilyIndex]
VUID-VkDeviceQueueCreateInfo-pQueuePriorities-00383
Each element of pQueuePriorities
must be between 0.0
and 1.0
inclusive
VUID-VkDeviceQueueCreateInfo-pNext-09398
If the pNext
chain includes a
VkDeviceQueueShaderCoreControlCreateInfoARM structure then
VkPhysicalDeviceSchedulingControlsPropertiesARM::schedulingControlsFlags
must contain
VK_PHYSICAL_DEVICE_SCHEDULING_CONTROLS_SHADER_CORE_COUNT_ARM
Valid Usage (Implicit)
VUID-VkDeviceQueueCreateInfo-sType-sType
sType
must be VK_STRUCTURE_TYPE_DEVICE_QUEUE_CREATE_INFO
VUID-VkDeviceQueueCreateInfo-pNext-pNext
Each pNext
member of any structure (including this one) in the pNext
chain must be either NULL
or a pointer to a valid instance of VkDeviceQueueGlobalPriorityCreateInfoKHR or VkDeviceQueueShaderCoreControlCreateInfoARM
VUID-VkDeviceQueueCreateInfo-sType-unique
The sType
value of each struct in the pNext
chain must be unique
VUID-VkDeviceQueueCreateInfo-flags-parameter
flags
must be a valid combination of VkDeviceQueueCreateFlagBits values
VUID-VkDeviceQueueCreateInfo-pQueuePriorities-parameter
pQueuePriorities
must be a valid pointer to an array of queueCount
float
values
VUID-VkDeviceQueueCreateInfo-queueCount-arraylength
queueCount
must be greater than 0