vkCreateMicromapEXT

To create a micromap, call:

VkResult vkCreateMicromapEXT(
    VkDevice                                           device,
    const VkMicromapCreateInfoEXT*                     pCreateInfo,
    const VkAllocationCallbacks*       pAllocator,
    VkMicromapEXT*                                     pMicromap);

pub fn create_micromap_ext(
    device: vk::Device,
    p_create_info: *const vk::MicromapCreateInfoEXT,
    p_allocator: *const vk::AllocationCallbacks,
    p_micromap: *mut vk::MicromapEXT,
) -> vk::Result;

• device is the logical device that creates the micromap structure object.
• pCreateInfo is a pointer to a VkMicromapCreateInfoEXT structure containing parameters affecting creation of the micromap.
• pAllocator controls host memory allocation as described in the Memory Allocation chapter.
• pMicromap is a pointer to a VkMicromapEXT handle in which the resulting micromap object is returned.

Similar to other objects in Vulkan, the micromap creation merely creates an object with a specific shape. The type and quantity of geometry that can be built into a micromap is determined by the parameters of VkMicromapCreateInfoEXT.

The micromap data is stored in the object referred to by VkMicromapCreateInfoEXT::buffer. Once memory has been bound to that buffer, it must be populated by micromap build or micromap copy commands such as vkCmdBuildMicromapsEXT, vkBuildMicromapsEXT, vkCmdCopyMicromapEXT, and vkCopyMicromapEXT.