vkCmdResolveImage2
To resolve a multisample image to a non-multisample image, call:
void vkCmdResolveImage2(
VkCommandBuffer commandBuffer,
const VkResolveImageInfo2* pResolveImageInfo);
pub fn cmd_resolve_image2(
command_buffer: vk::CommandBuffer,
p_resolve_image_info: *const vk::ResolveImageInfo2,
);
void vkCmdResolveImage2KHR(
VkCommandBuffer commandBuffer,
const VkResolveImageInfo2* pResolveImageInfo);
pub fn cmd_resolve_image2_khr(
command_buffer: vk::CommandBuffer,
p_resolve_image_info: *const vk::ResolveImageInfo2,
);
commandBufferis the command buffer into which the command will be recorded.pResolveImageInfois 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-commandBuffer-parameter
commandBuffer must be a valid VkCommandBuffer handle
VUID-vkCmdResolveImage2-pResolveImageInfo-parameter
pResolveImageInfo must be a valid pointer to a valid VkResolveImageInfo2 structure
VUID-vkCmdResolveImage2-commandBuffer-recording
commandBuffer must be in the recording state
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
commandBuffermust be externally synchronized - Host access to the
VkCommandPoolthatcommandBufferwas allocated from must be externally synchronized