To acquire an available presentable image to use, and retrieve the index of that image, call:
// Provided by VK_KHR_swapchain VkResult vkAcquireNextImageKHR( VkDevice device, VkSwapchainKHR swapchain, uint64_t timeout, VkSemaphore semaphore, VkFence fence, uint32_t* pImageIndex);
deviceis the device associated with
swapchainis the non-retired swapchain from which an image is being acquired.
timeoutspecifies how long the function waits, in nanoseconds, if no image is available.
semaphoreis VK_NULL_HANDLE or a semaphore to signal.
fenceis VK_NULL_HANDLE or a fence to signal.
pImageIndexis a pointer to a
uint32_tin which the index of the next image to use (i.e. an index into the array of images returned by
vkGetSwapchainImagesKHR) is returned.
swapchain has been created with the
VK_SWAPCHAIN_CREATE_DEFERRED_MEMORY_ALLOCATION_BIT_EXT flag, the image
whose index is returned in
pImageIndex will be fully backed by memory
before this call returns to the application, as if it is bound completely
and contiguously to a single
For more information, see the Vulkan Specification
This page is extracted from the Vulkan Specification. Fixes and changes should be made to the Specification, not directly.