Structures

VkBuildPartitionedAccelerationStructureInfoNV

Structure describing build parameters for a PTLAS

The VkBuildPartitionedAccelerationStructureInfoNV structure is defined as:

typedef struct VkBuildPartitionedAccelerationStructureInfoNV {
    VkStructureType sType;
    void* pNext;
    VkPartitionedAccelerationStructureInstancesInputNV input;
    VkDeviceAddress srcAccelerationStructureData;
    VkDeviceAddress dstAccelerationStructureData;
    VkDeviceAddress scratchData;
    VkDeviceAddress srcInfos;
    VkDeviceAddress srcInfosCount;
} VkBuildPartitionedAccelerationStructureInfoNV;
  • sType is a VkStructureType value identifying this structure.
  • pNext is NULL or a pointer to a structure extending this structure.
  • input is a VkPartitionedAccelerationStructureInstancesInputNV structure describing the instance and partition count information in the PTLAS.
  • srcAccelerationStructureData is NULL or an address of a previously built PTLAS. If non-NULL, the PTLAS stored at this address is used as a basis to create new PTLAS.
  • dstAccelerationStructureData is the address to store the built PTLAS.
  • scratchData is the device address of scratch memory that will be used during PTLAS build.
  • srcInfos is the device address of an array of VkBuildPartitionedAccelerationStructureIndirectCommandNV structures describing the type of operation to perform.
  • srcInfosCount is a device address containing the size of srcInfos array.

Members srcAccelerationStructureData and dstAccelerationStructureData may be the same or different. If they are the same, the update happens in-place. Otherwise, the destination acceleration structure is updated and the source is not modified.

Valid Usage

VUID-VkBuildPartitionedAccelerationStructureInfoNV-scratchData-10559

Memory at scratchData must be equal or larger than the VkAccelerationStructureBuildSizesInfoKHR::buildScratchSize value returned from vkGetPartitionedAccelerationStructuresBuildSizesNV with the same build parameters

VUID-VkBuildPartitionedAccelerationStructureInfoNV-srcAccelerationStructureData-10560

If srcAccelerationStructureData is not NULL, it must have previously been built as a PTLAS

VUID-VkBuildPartitionedAccelerationStructureInfoNV-dstAccelerationStructureData-10562

Memory at dstAccelerationStructureData must be equal or larger than the VkAccelerationStructureBuildSizesInfoKHR::accelerationStructureSize value returned from vkGetPartitionedAccelerationStructuresBuildSizesNV with the same build parameters