VkDeviceQueueCreateInfo

VkDeviceQueueCreateInfo is a Vulkan structure used to describe the device queues that should be created when a logical device is created with vkCreateDevice. It specifies how many queues to create from a given queue family and the relative priorities for those queues. You provide one or more VkDeviceQueueCreateInfo entries as part of the device creation process; the total number of queues created equals the sum of queueCount across all entries.

Key fields and their meaning:

- sType: must be VK_STRUCTURE_TYPE_DEVICE_QUEUE_CREATE_INFO.

- pNext: reserved for extension structures; typically NULL.

- queueFamilyIndex: the index of the queue family on the physical device from which these queues will be created.

- queueCount: the number of queues to create in this family.

- pQueuePriorities: a pointer to an array of floats, one priority value per queue; each value must be in the range [0.0, 1.0].

Usage notes:

- You typically create VkDeviceQueueCreateInfo entries for each queue family you intend to use, then pass them via VkDeviceCreateInfo to vkCreateDevice.

- The requested queues must not exceed the number of queues available in the specified family, as reported by VkQueueFamilyProperties.queueCount.

- The queue priorities influence scheduling when multiple queues are active; higher values indicate higher priority relative to other queues in the same family.

- After device creation, queues are retrieved with vkGetDeviceQueue (or related entry points) using the same queueFamilyIndex and a queueIndex in [0, queueCount).

VkDeviceQueueCreateInfo is fundamental for configuring concurrency and performance characteristics of a Vulkan application by controlling how many hardware queues are created and how they are prioritized.