vkCopyMicromapEXT
To copy or compact a micromap on the host, call:
VkResult vkCopyMicromapEXT(
VkDevice device,
VkDeferredOperationKHR deferredOperation,
const VkCopyMicromapInfoEXT* pInfo);
device
is the device which owns the micromaps.deferredOperation
is an optional VkDeferredOperationKHR to request deferral for this command.pInfo
is a pointer to a VkCopyMicromapInfoEXT structure defining the copy operation.
This command fulfills the same task as vkCmdCopyMicromapEXT but is executed by the host.
Valid Usage
VUID-vkCopyMicromapEXT-deferredOperation-03678
Any previous deferred operation that was associated with
deferredOperation
must be complete
VUID-vkCopyMicromapEXT-buffer-07558
The buffer
used to create pInfo→src
must be bound to
host-visible device memory
VUID-vkCopyMicromapEXT-buffer-07559
The buffer
used to create pInfo→dst
must be bound to
host-visible device memory
VUID-vkCopyMicromapEXT-micromapHostCommands-07560
The VkPhysicalDeviceOpacityMicromapFeaturesEXT
::micromapHostCommands
feature must be enabled
VUID-vkCopyMicromapEXT-buffer-07561
The buffer
used to create pInfo→src
must be bound to
memory that was not allocated with multiple instances
VUID-vkCopyMicromapEXT-buffer-07562
The buffer
used to create pInfo→dst
must be bound to
memory that was not allocated with multiple instances
Valid Usage (Implicit)
VUID-vkCopyMicromapEXT-device-parameter
device
must be a valid VkDevice handle
VUID-vkCopyMicromapEXT-deferredOperation-parameter
If deferredOperation
is not VK_NULL_HANDLE, deferredOperation
must be a valid VkDeferredOperationKHR handle
VUID-vkCopyMicromapEXT-pInfo-parameter
pInfo
must be a valid pointer to a valid VkCopyMicromapInfoEXT structure
VUID-vkCopyMicromapEXT-deferredOperation-parent
If deferredOperation
is a valid handle, it must have been created, allocated, or retrieved from device