vkCreateAccelerationStructureKHR

To create an acceleration structure using a buffer, call:

VkResult vkCreateAccelerationStructureKHR(
    VkDevice                                           device,
    const VkAccelerationStructureCreateInfoKHR*        pCreateInfo,
    const VkAllocationCallbacks*       pAllocator,
    VkAccelerationStructureKHR*                        pAccelerationStructure);

pub fn create_acceleration_structure_khr(
    device: vk::Device,
    p_create_info: *const vk::AccelerationStructureCreateInfoKHR,
    p_allocator: *const vk::AllocationCallbacks,
    p_acceleration_structure: *mut vk::AccelerationStructureKHR,
) -> vk::Result;

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

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

The acceleration structure data is stored in the object referred to by VkAccelerationStructureCreateInfoKHR::buffer. Once memory has been bound to that buffer, it must be populated by acceleration structure build or acceleration structure copy commands such as vkCmdBuildAccelerationStructuresKHR, vkBuildAccelerationStructuresKHR, vkCmdCopyAccelerationStructureKHR, and vkCopyAccelerationStructureKHR.

The input buffers passed to acceleration structure build commands will be referenced by the implementation for the duration of the command. After the command completes, the acceleration structure may hold a reference to any acceleration structure specified by an active instance contained therein. Apart from this referencing, acceleration structures must be fully self-contained. The application can reuse or free any memory which was used by the command as an input or as scratch without affecting the results of ray traversal.