vkCmdCopyMemoryToMicromapEXT(3)

Name

vkCmdCopyMemoryToMicromapEXT - Copy device memory to a micromap

C Specification

To copy device memory to a micromap call:

// Provided by VK_EXT_opacity_micromap
void vkCmdCopyMemoryToMicromapEXT(
    VkCommandBuffer                             commandBuffer,
    const VkCopyMemoryToMicromapInfoEXT*        pInfo);

Parameters

commandBuffer is the command buffer into which the command will be recorded.
pInfo is a pointer to a VkCopyMemoryToMicromapInfoEXT structure defining the copy operation.

Description

Accesses to 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_WRITE_BIT_EXT. Accesses to the buffer indicated by pInfo->src must be synchronized with the VK_PIPELINE_STAGE_2_MICROMAP_BUILD_BIT_EXT pipeline stage and an access type of VK_ACCESS_TRANSFER_READ_BIT.

This command can accept micromaps produced by either vkCopyMicromapToMemoryEXT or vkCmdCopyMicromapToMemoryEXT.

Valid Usage

VUID-vkCmdCopyMemoryToMicromapEXT-pInfo-07543
pInfo->src.deviceAddress must be a valid VkDeviceAddress
VUID-vkCmdCopyMemoryToMicromapEXT-pInfo-07544
pInfo->src.deviceAddress must be aligned to 256 bytes
VUID-vkCmdCopyMemoryToMicromapEXT-buffer-07546
The buffer used to create pInfo->dst must be bound to device memory

Valid Usage (Implicit)

VUID-vkCmdCopyMemoryToMicromapEXT-commandBuffer-parameter
commandBuffer must be a valid VkCommandBuffer handle
VUID-vkCmdCopyMemoryToMicromapEXT-pInfo-parameter
pInfo must be a valid pointer to a valid VkCopyMemoryToMicromapInfoEXT structure
VUID-vkCmdCopyMemoryToMicromapEXT-commandBuffer-recording
commandBuffer must be in the recording state
VUID-vkCmdCopyMemoryToMicromapEXT-commandBuffer-cmdpool
The VkCommandPool that commandBuffer was allocated from must support VK_QUEUE_COMPUTE_BIT operations
VUID-vkCmdCopyMemoryToMicromapEXT-renderpass
This command must only be called outside of a render pass instance
VUID-vkCmdCopyMemoryToMicromapEXT-suspended
This command must not be called between suspended render pass instances
VUID-vkCmdCopyMemoryToMicromapEXT-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