Function Prototype

vkCmdResolveImage2

Resolve regions of an image

To resolve a multisample image to a non-multisample image, call:

void vkCmdResolveImage2(
    VkCommandBuffer commandBuffer,
    const VkResolveImageInfo2* pResolveImageInfo);
void vkCmdResolveImage2KHR(
    VkCommandBuffer commandBuffer,
    const VkResolveImageInfo2* pResolveImageInfo);
  • commandBuffer is the command buffer into which the command will be recorded.
  • pResolveImageInfo is a pointer to a VkResolveImageInfo2 structure describing the resolve parameters.

This command is functionally identical to vkCmdResolveImage, but includes extensible sub-structures that include sType and pNext parameters, allowing them to be more easily extended.

Valid Usage

VUID-vkCmdResolveImage2-commandBuffer-01837

If commandBuffer is an unprotected command buffer and protectedNoFault is not supported, srcImage must not be a protected image

VUID-vkCmdResolveImage2-commandBuffer-01838

If commandBuffer is an unprotected command buffer and protectedNoFault is not supported, dstImage must not be a protected image

VUID-vkCmdResolveImage2-commandBuffer-01839

If commandBuffer is a protected command buffer and protectedNoFault is not supported, dstImage must not be an unprotected image

Valid Usage (Implicit)

VUID-vkCmdResolveImage2-pResolveImageInfo-parameter

pResolveImageInfo must be a valid pointer to a valid VkResolveImageInfo2 structure

VUID-vkCmdResolveImage2-commandBuffer-cmdpool

The VkCommandPool that commandBuffer was allocated from must support VK_QUEUE_GRAPHICS_BIT operations

VUID-vkCmdResolveImage2-renderpass

This command must only be called outside of a render pass instance

VUID-vkCmdResolveImage2-suspended

This command must not be called between suspended render pass instances

VUID-vkCmdResolveImage2-videocoding

This command must only be called outside of a video coding scope

Host Synchronization

  • Host access to commandBuffer must be externally synchronized
  • Host access to the VkCommandPool that commandBuffer was allocated from must be externally synchronized