Structures

VkDeviceQueueCreateInfo

Structure specifying parameters of a newly created device queue

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 is NULL 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 the pQueueFamilyProperties array that was returned by vkGetPhysicalDeviceQueueFamilyProperties.
  • queueCount is an unsigned integer specifying the number of queues to create in the queue family indicated by queueFamilyIndex, and with the behavior specified by flags.
  • pQueuePriorities is a pointer to an array of queueCount 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::schedulingControlsFlagsmust 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-pQueuePriorities-parameter

pQueuePriorities must be a valid pointer to an array of queueCount float values