Function Prototype

vkCmdResolveImage2

Resolve regions of an image

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

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 (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 graphics operations

VUID-vkCmdResolveImage2-renderpass

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

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 ::