vkGetDeviceQueue

vkGetDeviceQueue is a Vulkan API function that retrieves a handle to a device queue associated with a logical device. The function does not create or modify queues; queues are created when the logical device is created, and vkGetDeviceQueue simply returns a handle to an existing queue.

Prototype: void vkGetDeviceQueue(VkDevice device, uint32_t queueFamilyIndex, uint32_t queueIndex, VkQueue* pQueue);

Parameters: device is a valid VkDevice representing the logical device. queueFamilyIndex selects a queue family from the device’s queue families as reported by VkPhysicalDeviceQueueFamilyProperties. queueIndex selects a specific queue within that family. pQueue is an output parameter that receives the VkQueue handle.

Behavior: The returned handle can be used with queue submission commands such as vkQueueSubmit and for synchronization operations like vkQueueWaitIdle. The specified queue family must have at least one queue (the device must have been created with a corresponding queueCount > 0). queueIndex must be less than the number of queues in that family. The lifetime of the queue is tied to the device; the handle remains valid until the device is destroyed or the process terminates.

Usage: Typical workflow is to create a logical device with one or more queueCreateInfo entries, then call vkGetDeviceQueue to obtain handles for the queues you intend to use, usually one per thread or per task type. Multiple queues can be retrieved from the same family by varying queueIndex.

See also: VkDevice, VkQueue, vkCreateDevice, vkQueueSubmit.