VkRayTracingPipelineClusterAccelerationStructureCreateInfoNV(3)

# VkRayTracingPipelineClusterAccelerationStructureCreateInfoNV(3) Manual Page

## Name

VkRayTracingPipelineClusterAccelerationStructureCreateInfoNV - Structure controlling if cluster acceleration structures are allowed

## C Specification

The VkRayTracingPipelineClusterAccelerationStructureCreateInfoNV structure is defined as:

    // Provided by VK_KHR_ray_tracing_pipeline with VK_NV_cluster_acceleration_structure
    typedef struct VkRayTracingPipelineClusterAccelerationStructureCreateInfoNV {
        VkStructureType    sType;
        void*              pNext;
        VkBool32           allowClusterAccelerationStructure;
    } VkRayTracingPipelineClusterAccelerationStructureCreateInfoNV;

## Members

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

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

- `allowClusterAccelerationStructure` controls if cluster acceleration structures are allowed in the ray tracing pipeline.

## Description

If no cluster acceleration structures are present in the ray tracing pipeline, `allowClusterAccelerationStructure` should not be used to prevent traversal penalty on some implementations.

Valid Usage

- VUID-VkRayTracingPipelineClusterAccelerationStructureCreateInfoNV-clusterAccelerationStructure-10576
  The `VkPhysicalDeviceClusterAccelerationStructureFeaturesNV`::`clusterAccelerationStructure` feature must be enabled

Valid Usage (Implicit)

- VUID-VkRayTracingPipelineClusterAccelerationStructureCreateInfoNV-sType-sType
  `sType` must be VK_STRUCTURE_TYPE_RAY_TRACING_PIPELINE_CLUSTER_ACCELERATION_STRUCTURE_CREATE_INFO_NV

Structure Chaining

Extends the structure

  - VkRayTracingPipelineCreateInfoKHR

## See Also

VK_KHR_ray_tracing_pipeline, VK_NV_cluster_acceleration_structure, VkBool32, VkStructureType

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