VkClusterAccelerationStructureInputInfoNV(3)

# VkClusterAccelerationStructureInputInfoNV(3) Manual Page

## Name

VkClusterAccelerationStructureInputInfoNV - Structure describing a cluster acceleration structure

## C Specification

The VkClusterAccelerationStructureInputInfoNV structure is defined as:

    // Provided by VK_NV_cluster_acceleration_structure
    typedef struct VkClusterAccelerationStructureInputInfoNV {
        VkStructureType                            sType;
        void*                                      pNext;
        uint32_t                                   maxAccelerationStructureCount;
        VkBuildAccelerationStructureFlagsKHR       flags;
        VkClusterAccelerationStructureOpTypeNV     opType;
        VkClusterAccelerationStructureOpModeNV     opMode;
        VkClusterAccelerationStructureOpInputNV    opInput;
    } VkClusterAccelerationStructureInputInfoNV;

## Members

- `sType` is a VkStructureType value identifying this structure.

- `pNext` is `NULL` or a pointer to a structure extending this structure.

- `maxAccelerationStructureCount` is the maximum number of acceleration structures that will be provided to the multi indirect operation.

- `flags` is a bitmask of VkBuildAccelerationStructureFlagsKHR specifying flags for the multi indirect operation.

- `opType` is a VkClusterAccelerationStructureOpTypeNV value specifying the type of operation to perform.

- `opMode` is a VkClusterAccelerationStructureOpModeNV value specifying the mode of operation.

- `opInput` is a VkClusterAccelerationStructureOpInputNV value specifying the descriptions of the operation.

## Description

Valid Usage (Implicit)

- VUID-VkClusterAccelerationStructureInputInfoNV-sType-sType
  `sType` must be VK_STRUCTURE_TYPE_CLUSTER_ACCELERATION_STRUCTURE_INPUT_INFO_NV

- VUID-VkClusterAccelerationStructureInputInfoNV-pNext-pNext
  `pNext` must be `NULL`

- VUID-VkClusterAccelerationStructureInputInfoNV-flags-parameter
  `flags` must be a valid combination of VkBuildAccelerationStructureFlagBitsKHR values

- VUID-VkClusterAccelerationStructureInputInfoNV-opType-parameter
  `opType` must be a valid VkClusterAccelerationStructureOpTypeNV value

- VUID-VkClusterAccelerationStructureInputInfoNV-opMode-parameter
  `opMode` must be a valid VkClusterAccelerationStructureOpModeNV value

- VUID-VkClusterAccelerationStructureInputInfoNV-pClustersBottomLevel-parameter
  If `opType` is VK_CLUSTER_ACCELERATION_STRUCTURE_OP_TYPE_BUILD_CLUSTERS_BOTTOM_LEVEL_NV, the `pClustersBottomLevel` member of `opInput` must be a valid pointer to a VkClusterAccelerationStructureClustersBottomLevelInputNV structure

- VUID-VkClusterAccelerationStructureInputInfoNV-pTriangleClusters-parameter
  If `opType` is VK_CLUSTER_ACCELERATION_STRUCTURE_OP_TYPE_BUILD_TRIANGLE_CLUSTER_NV, VK_CLUSTER_ACCELERATION_STRUCTURE_OP_TYPE_BUILD_TRIANGLE_CLUSTER_TEMPLATE_NV, VK_CLUSTER_ACCELERATION_STRUCTURE_OP_TYPE_INSTANTIATE_TRIANGLE_CLUSTER_NV, or VK_CLUSTER_ACCELERATION_STRUCTURE_OP_TYPE_GET_CLUSTER_TEMPLATE_INDICES_NV, the `pTriangleClusters` member of `opInput` must be a valid pointer to a VkClusterAccelerationStructureTriangleClusterInputNV structure

- VUID-VkClusterAccelerationStructureInputInfoNV-pMoveObjects-parameter
  If `opType` is VK_CLUSTER_ACCELERATION_STRUCTURE_OP_TYPE_MOVE_OBJECTS_NV, the `pMoveObjects` member of `opInput` must be a valid pointer to a VkClusterAccelerationStructureMoveObjectsInputNV structure

## See Also

VK_NV_cluster_acceleration_structure, VkBuildAccelerationStructureFlagsKHR, VkClusterAccelerationStructureCommandsInfoNV, VkClusterAccelerationStructureOpInputNV, VkClusterAccelerationStructureOpModeNV, VkClusterAccelerationStructureOpTypeNV, VkStructureType, vkGetClusterAccelerationStructureBuildSizesNV

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