VulkanHub
Function Prototype

vkDestroyAccelerationStructureNV

Destroy an acceleration structure object

To destroy an acceleration structure, call:

void vkDestroyAccelerationStructureNV(
    VkDevice device,
    VkAccelerationStructureNV accelerationStructure,
    const VkAllocationCallbacks* pAllocator);
  • device is the logical device that destroys the buffer.
  • accelerationStructure is the acceleration structure to destroy.
  • pAllocator controls host memory allocation as described in the Memory Allocation chapter.

Valid Usage

VUID-vkDestroyAccelerationStructureNV-accelerationStructure-03752

All submitted commands that refer to accelerationStructure must have completed execution

VUID-vkDestroyAccelerationStructureNV-accelerationStructure-03753

If VkAllocationCallbacks were provided when accelerationStructure was created, a compatible set of callbacks must be provided here

VUID-vkDestroyAccelerationStructureNV-accelerationStructure-03754

If no VkAllocationCallbacks were provided when accelerationStructure was created, pAllocator must be NULL

Valid Usage (Implicit)

VUID-vkDestroyAccelerationStructureNV-device-parameter

device must be a valid VkDevice handle

VUID-vkDestroyAccelerationStructureNV-accelerationStructure-parameter

If accelerationStructure is not VK_NULL_HANDLE, accelerationStructure must be a valid VkAccelerationStructureNV handle

VUID-vkDestroyAccelerationStructureNV-pAllocator-parameter

If pAllocator is not NULL, pAllocator must be a valid pointer to a valid VkAllocationCallbacks structure

VUID-vkDestroyAccelerationStructureNV-accelerationStructure-parent

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

Host Synchronization

  • Host access to accelerationStructure must be externally synchronized ::