VkPartitionedAccelerationStructureInstancesInputNV(3)

# VkPartitionedAccelerationStructureInstancesInputNV(3) Manual Page

## Name

VkPartitionedAccelerationStructureInstancesInputNV - Parameters describing a PTLAS structure

## C Specification

The VkPartitionedAccelerationStructureInstancesInputNV structure is defined as:

    // 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

- VUID-VkPartitionedAccelerationStructureInstancesInputNV-partitionCount-10535
  The sum of `partitionCount` and `maxInstanceInGlobalPartitionCount` must be less than or equal to VkPhysicalDevicePartitionedAccelerationStructurePropertiesNV::`maxPartitionCount`

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

VK_NV_partitioned_acceleration_structure, VkBuildAccelerationStructureFlagsKHR, VkBuildPartitionedAccelerationStructureInfoNV, VkStructureType, vkGetPartitionedAccelerationStructuresBuildSizesNV

## 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

Copyright 2014-2026 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0