Function Prototype

vkCopyMicromapToMemoryEXT

Serialize a micromap on the host

To copy a micromap to host accessible memory, call:

VkResult vkCopyMicromapToMemoryEXT(
    VkDevice device,
    VkDeferredOperationKHR deferredOperation,
    const VkCopyMicromapToMemoryInfoEXT* pInfo);

This command fulfills the same task as vkCmdCopyMicromapToMemoryEXT but is executed by the host.

This command produces the same results as vkCmdCopyMicromapToMemoryEXT, but writes its result directly to a host pointer, and is executed on the host rather than the device. The output may not necessarily be bit-for-bit identical, but it can be equally used by either vkCmdCopyMemoryToMicromapEXT or vkCopyMemoryToMicromapEXT.

Valid Usage

VUID-vkCopyMicromapToMemoryEXT-deferredOperation-03678

Any previous deferred operation that was associated with deferredOperation must be complete

VUID-vkCopyMicromapToMemoryEXT-buffer-07568

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

VUID-vkCopyMicromapToMemoryEXT-pInfo-07569

pInfo→dst.hostAddress must be a valid host pointer

VUID-vkCopyMicromapToMemoryEXT-pInfo-07570

pInfo→dst.hostAddress must be aligned to 16 bytes

VUID-vkCopyMicromapToMemoryEXT-buffer-07572

The buffer used to create pInfo→src must be bound to memory that was not allocated with multiple instances

Valid Usage (Implicit)

VUID-vkCopyMicromapToMemoryEXT-deferredOperation-parameter

If deferredOperation is not VK_NULL_HANDLE, deferredOperation must be a valid VkDeferredOperationKHR handle

VUID-vkCopyMicromapToMemoryEXT-pInfo-parameter

pInfo must be a valid pointer to a valid VkCopyMicromapToMemoryInfoEXT structure

VUID-vkCopyMicromapToMemoryEXT-deferredOperation-parent

If deferredOperation is a valid handle, it must have been created, allocated, or retrieved from device