## C Specification

The VkCopyImageToBufferInfo2 structure is defined as:

// Provided by VK_VERSION_1_3
typedef struct VkCopyImageToBufferInfo2 {
VkStructureType              sType;
const void*                  pNext;
VkImage                      srcImage;
VkImageLayout                srcImageLayout;
VkBuffer                     dstBuffer;
uint32_t                     regionCount;
const VkBufferImageCopy2*    pRegions;
} VkCopyImageToBufferInfo2;

or the equivalent

// Provided by VK_KHR_copy_commands2
typedef VkCopyImageToBufferInfo2 VkCopyImageToBufferInfo2KHR;

## Members

• sType is the type of this structure.

• pNext is NULL or a pointer to a structure extending this structure.

• srcImage is the source image.

• srcImageLayout is the layout of the source image subresources for the copy.

• dstBuffer is the destination buffer.

• regionCount is the number of regions to copy.

• pRegions is a pointer to an array of VkBufferImageCopy2 structures specifying the regions to copy.

## Description

Valid Usage
• VUID-VkCopyImageToBufferInfo2-pRegions-00183
dstBuffer must be large enough to contain all buffer locations that are accessed according to Buffer and Image Addressing, for each element of pRegions

• VUID-VkCopyImageToBufferInfo2-pRegions-00184
The union of all source regions, and the union of all destination regions, specified by the elements of pRegions, must not overlap in memory

• VUID-VkCopyImageToBufferInfo2-srcImage-00186
srcImage must have been created with VK_IMAGE_USAGE_TRANSFER_SRC_BIT usage flag

• VUID-VkCopyImageToBufferInfo2-srcImage-01998
The format features of srcImage must contain VK_FORMAT_FEATURE_TRANSFER_SRC_BIT

• VUID-VkCopyImageToBufferInfo2-srcImage-00187
If srcImage is non-sparse then it must be bound completely and contiguously to a single VkDeviceMemory object

• VUID-VkCopyImageToBufferInfo2-dstBuffer-00191
dstBuffer must have been created with VK_BUFFER_USAGE_TRANSFER_DST_BIT usage flag

• VUID-VkCopyImageToBufferInfo2-dstBuffer-00192
If dstBuffer is non-sparse then it must be bound completely and contiguously to a single VkDeviceMemory object

• VUID-VkCopyImageToBufferInfo2-srcImage-00188
srcImage must have a sample count equal to VK_SAMPLE_COUNT_1_BIT

• VUID-VkCopyImageToBufferInfo2-srcImageLayout-00189
srcImageLayout must specify the layout of the image subresources of srcImage specified in pRegions at the time this command is executed on a VkDevice

• VUID-VkCopyImageToBufferInfo2-srcImageLayout-01397
srcImageLayout must be VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL, VK_IMAGE_LAYOUT_GENERAL, or VK_IMAGE_LAYOUT_SHARED_PRESENT_KHR

• VUID-VkCopyImageToBufferInfo2-imageSubresource-01703
The imageSubresource.mipLevel member of each element of pRegions must be less than the mipLevels specified in VkImageCreateInfo when srcImage was created

• VUID-VkCopyImageToBufferInfo2-imageSubresource-01704
The imageSubresource.baseArrayLayer + imageSubresource.layerCount of each element of pRegions must be less than or equal to the arrayLayers specified in VkImageCreateInfo when srcImage was created

• VUID-VkCopyImageToBufferInfo2-imageOffset-01794
The imageOffset and imageExtent members of each element of pRegions must respect the image transfer granularity requirements of commandBuffer’s command pool’s queue family, as described in VkQueueFamilyProperties

• VUID-VkCopyImageToBufferInfo2-srcImage-02544
srcImage must not have been created with flags containing VK_IMAGE_CREATE_SUBSAMPLED_BIT_EXT

• VUID-VkCopyImageToBufferInfo2-imageOffset-00197
For each element of pRegions not containing VkCopyCommandTransformInfoQCOM in its pNext chain, imageOffset.x and (imageExtent.width + imageOffset.x) must both be greater than or equal to 0 and less than or equal to the width of the specified imageSubresource of srcImage

• VUID-VkCopyImageToBufferInfo2-imageOffset-00198
For each element of pRegions not containing VkCopyCommandTransformInfoQCOM in its pNext chain, imageOffset.y and (imageExtent.height + imageOffset.y) must both be greater than or equal to 0 and less than or equal to the height of the specified imageSubresource of srcImage

• VUID-VkCopyImageToBufferInfo2-bufferOffset-01558
If srcImage does not have either a depth/stencil or a multi-planar format, then for each element of pRegions, bufferOffset must be a multiple of the format’s texel block size

• VUID-VkCopyImageToBufferInfo2-bufferOffset-01559
If srcImage has a multi-planar format, then for each element of pRegions, bufferOffset must be a multiple of the element size of the compatible format for the format and the aspectMask of the imageSubresource as defined in [formats-compatible-planes]

• VUID-VkCopyImageToBufferInfo2-srcImage-00199
If srcImage is of type VK_IMAGE_TYPE_1D, then for each element of pRegions, imageOffset.y must be 0 and imageExtent.height must be 1

• VUID-VkCopyImageToBufferInfo2-imageOffset-00200
For each element of pRegions, imageOffset.z and (imageExtent.depth + imageOffset.z) must both be greater than or equal to 0 and less than or equal to the depth of the specified imageSubresource of srcImage

• VUID-VkCopyImageToBufferInfo2-srcImage-00201
If srcImage is of type VK_IMAGE_TYPE_1D or VK_IMAGE_TYPE_2D, then for each element of pRegions, imageOffset.z must be 0 and imageExtent.depth must be 1

• VUID-VkCopyImageToBufferInfo2-bufferRowLength-00203
For each element of pRegions, bufferRowLength must be a multiple of the texel block extent width of the VkFormat of srcImage

• VUID-VkCopyImageToBufferInfo2-bufferImageHeight-00204
For each element of pRegions, bufferImageHeight must be a multiple of the texel block extent height of the VkFormat of srcImage

• VUID-VkCopyImageToBufferInfo2-pRegions-07273
For each element of pRegions, bufferOffset must be a multiple of the texel block size of the VkFormat of srcImage

• VUID-VkCopyImageToBufferInfo2-pRegions-07274
For each element of pRegions, imageOffset.x must be a multiple of the texel block extent width of the VkFormat of srcImage

• VUID-VkCopyImageToBufferInfo2-pRegions-07275
For each element of pRegions, imageOffset.y must be a multiple of the texel block extent height of the VkFormat of srcImage

• VUID-VkCopyImageToBufferInfo2-pRegions-07276
For each element of pRegions, imageOffset.z must be a multiple of the texel block extent depth of the VkFormat of srcImage

• VUID-VkCopyImageToBufferInfo2-imageExtent-00207
For each element of pRegions, if the sum of imageOffset.x and extent.width does not equal the width of the the subresource specified by srcSubresource, extent.width must be a multiple of the texel block extent width of the VkFormat of srcImage

• VUID-VkCopyImageToBufferInfo2-imageExtent-00208
For each element of pRegions, if the sum of imageOffset.y and extent.height does not equal the height of the the subresource specified by srcSubresource, extent.height must be a multiple of the texel block extent height of the VkFormat of srcImage

• VUID-VkCopyImageToBufferInfo2-imageExtent-00209
For each element of pRegions, if the sum of imageOffset.z and extent.depth does not equal the depth of the the subresource specified by srcSubresource, extent.depth must be a multiple of the texel block extent depth of the VkFormat of srcImage

For each element of pRegions, imageSubresource.aspectMask must specify aspects present in srcImage

If srcImage has a multi-planar format, then for each element of pRegions, imageSubresource.aspectMask must be VK_IMAGE_ASPECT_PLANE_0_BIT, VK_IMAGE_ASPECT_PLANE_1_BIT, or VK_IMAGE_ASPECT_PLANE_2_BIT (with VK_IMAGE_ASPECT_PLANE_2_BIT valid only for image formats with three planes)

• VUID-VkCopyImageToBufferInfo2-baseArrayLayer-00213
If srcImage is of type VK_IMAGE_TYPE_3D, for each element of pRegions, imageSubresource.baseArrayLayer must be 0 and imageSubresource.layerCount must be 1

• VUID-VkCopyImageToBufferInfo2-pRegions-07277
For each element of pRegions, bufferRowLength divided by the texel block extent width and then multiplied by the texel block size of srcImage must be less than or equal to 231-1

• VUID-VkCopyImageToBufferInfo2-commandBuffer-04052
If the queue family used to create the VkCommandPool which commandBuffer was allocated from does not support VK_QUEUE_GRAPHICS_BIT or VK_QUEUE_COMPUTE_BIT, the bufferOffset member of any element of pRegions must be a multiple of 4

• VUID-VkCopyImageToBufferInfo2-srcImage-04053
If srcImage has a depth/stencil format, the bufferOffset member of any element of pRegions must be a multiple of 4

Valid Usage (Implicit)
• VUID-VkCopyImageToBufferInfo2-sType-sType
sType must be VK_STRUCTURE_TYPE_COPY_IMAGE_TO_BUFFER_INFO_2

• VUID-VkCopyImageToBufferInfo2-pNext-pNext
pNext must be NULL

• VUID-VkCopyImageToBufferInfo2-srcImage-parameter
srcImage must be a valid VkImage handle

• VUID-VkCopyImageToBufferInfo2-srcImageLayout-parameter
srcImageLayout must be a valid VkImageLayout value

• VUID-VkCopyImageToBufferInfo2-dstBuffer-parameter
dstBuffer must be a valid VkBuffer handle

• VUID-VkCopyImageToBufferInfo2-pRegions-parameter
pRegions must be a valid pointer to an array of regionCount valid VkBufferImageCopy2 structures

• VUID-VkCopyImageToBufferInfo2-regionCount-arraylength
regionCount must be greater than 0

• VUID-VkCopyImageToBufferInfo2-commonparent
Both of dstBuffer, and srcImage must have been created, allocated, or retrieved from the same VkDevice