C Specification

// Provided by VK_NV_partitioned_acceleration_structure
typedef struct VkPartitionedAccelerationStructureInstancesInputNV {
    VkStructureType                         sType;
    void*                                   pNext;
    VkBuildAccelerationStructureFlagsKHR    flags;
    uint32_t                                instanceCount;
    uint32_t                                maxInstancePerPartitionCount;
    uint32_t                                partitionCount;
    uint32_t                                maxInstanceInGlobalPartitionCount;
} VkPartitionedAccelerationStructureInstancesInputNV;

Members

  • sType is a VkStructureType value identifying this structure.

  • pNext is NULL or a pointer to a structure extending this structure.

  • flags is a bitmask of VkBuildAccelerationStructureFlagsKHR specifying flags for the PTLAS build operation.

  • instanceCount is the number of instances in this PTLAS.

  • maxInstancePerPartitionCount is the maximum number of instances per partition in the PTLAS.

  • partitionCount is the number of partitions in the PTLAS.

  • maxInstanceInGlobalPartitionCount is maximum number of instances in the global partition.

Description

If the pNext chain includes a VkPartitionedAccelerationStructureFlagsNV structure, then that structure specifies additional flags for the PTLAS.

Valid Usage
Valid Usage (Implicit)
  • VUID-VkPartitionedAccelerationStructureInstancesInputNV-sType-sType
    sType must be VK_STRUCTURE_TYPE_PARTITIONED_ACCELERATION_STRUCTURE_INSTANCES_INPUT_NV

  • VUID-VkPartitionedAccelerationStructureInstancesInputNV-pNext-pNext
    pNext must be NULL or a pointer to a valid instance of VkPartitionedAccelerationStructureFlagsNV

  • VUID-VkPartitionedAccelerationStructureInstancesInputNV-sType-unique
    The sType value of each structure in the pNext chain must be unique

  • VUID-VkPartitionedAccelerationStructureInstancesInputNV-flags-parameter
    flags must be a valid combination of VkBuildAccelerationStructureFlagBitsKHR values

See Also

Document Notes

For more information, see the Vulkan Specification

This page is extracted from the Vulkan Specification. Fixes and changes should be made to the Specification, not directly.

Copyright 2014-2025 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0