VkBindImageMemorySwapchainInfoKHR
If the pNext
chain of VkBindImageMemoryInfo includes a
VkBindImageMemorySwapchainInfoKHR
structure, then that structure
includes a swapchain handle and image index indicating that the image will
be bound to memory from that swapchain.
The VkBindImageMemorySwapchainInfoKHR
structure is defined as:
typedef struct VkBindImageMemorySwapchainInfoKHR {
VkStructureType sType;
const void* pNext;
VkSwapchainKHR swapchain;
uint32_t imageIndex;
} VkBindImageMemorySwapchainInfoKHR;
sType
is a VkStructureType value identifying this structure.pNext
isNULL
or a pointer to a structure extending this structure.swapchain
is VK_NULL_HANDLE or a swapchain handle.imageIndex
is an image index withinswapchain
.
If swapchain
is not NULL
, the swapchain
and imageIndex
are used to determine the memory that the image is bound to, instead of
memory
and memoryOffset
.
Memory can be bound to a swapchain and use the pDeviceIndices
or
pSplitInstanceBindRegions
members of
VkBindImageMemoryDeviceGroupInfo.
Valid Usage
VUID-VkBindImageMemorySwapchainInfoKHR-imageIndex-01644
imageIndex
must be less than the number of images in
swapchain
VUID-VkBindImageMemorySwapchainInfoKHR-swapchain-07756
If the swapchain
has been created with
VK_SWAPCHAIN_CREATE_DEFERRED_MEMORY_ALLOCATION_BIT_EXT
,
imageIndex
must be one that has previously been returned by
vkAcquireNextImageKHR or vkAcquireNextImage2KHR
Valid Usage (Implicit)
VUID-VkBindImageMemorySwapchainInfoKHR-sType-sType
sType
must be VK_STRUCTURE_TYPE_BIND_IMAGE_MEMORY_SWAPCHAIN_INFO_KHR
VUID-VkBindImageMemorySwapchainInfoKHR-swapchain-parameter
swapchain
must be a valid VkSwapchainKHR handle
Host Synchronization
- Host access to
swapchain
must be externally synchronized ::