Function Prototype

vkCmdCopyMicromapEXT

Copy a micromap
primary / secondary
outside
compute
action

To copy a micromap call:

void vkCmdCopyMicromapEXT(
    VkCommandBuffer commandBuffer,
    const VkCopyMicromapInfoEXT* pInfo);
  • commandBuffer is the command buffer into which the command will be recorded.
  • pInfo is a pointer to a VkCopyMicromapInfoEXT structure defining the copy operation.

This command copies the pInfo→src micromap to the pInfo→dst micromap in the manner specified by pInfo→mode.

Accesses to pInfo→src and pInfo→dst must be synchronized with the VK_PIPELINE_STAGE_2_MICROMAP_BUILD_BIT_EXT

pipeline stage and an access type of VK_ACCESS_2_MICROMAP_READ_BIT_EXT or VK_ACCESS_2_MICROMAP_WRITE_BIT_EXT as appropriate.

Valid Usage

VUID-vkCmdCopyMicromapEXT-buffer-07529

The buffer used to create pInfo→src must be bound to device memory

VUID-vkCmdCopyMicromapEXT-buffer-07530

The buffer used to create pInfo→dst must be bound to device memory

Valid Usage (Implicit)

VUID-vkCmdCopyMicromapEXT-pInfo-parameter

pInfo must be a valid pointer to a valid VkCopyMicromapInfoEXT structure

VUID-vkCmdCopyMicromapEXT-commandBuffer-cmdpool

The VkCommandPool that commandBuffer was allocated from must support compute operations

VUID-vkCmdCopyMicromapEXT-renderpass

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

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