VkWriteDescriptorSetPartitionedAccelerationStructureNV(3)

# VkWriteDescriptorSetPartitionedAccelerationStructureNV(3) Manual Page

## Name

VkWriteDescriptorSetPartitionedAccelerationStructureNV - Structure specifying descriptor for PTLAS

## C Specification

If the `descriptorType` member of VkWriteDescriptorSet is VK_DESCRIPTOR_TYPE_PARTITIONED_ACCELERATION_STRUCTURE_NV, then the data to write to the descriptor set is specified through a `VkWriteDescriptorSetPartitionedAccelerationStructureNV` structure included in the `pNext` chain of `VkWriteDescriptorSet`.

The `VkWriteDescriptorSetPartitionedAccelerationStructureNV` structure is defined as:

    // Provided by VK_NV_partitioned_acceleration_structure
    typedef struct VkWriteDescriptorSetPartitionedAccelerationStructureNV {
        VkStructureType           sType;
        void*                     pNext;
        uint32_t                  accelerationStructureCount;
        const VkDeviceAddress*    pAccelerationStructures;
    } VkWriteDescriptorSetPartitionedAccelerationStructureNV;

## Members

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

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

- `accelerationStructureCount` is the number of elements in `pAccelerationStructures`.

- `pAccelerationStructures` is a pointer to an array of `accelerationStructureCount` device addresses pointing to previously built PTLAS.

## Description

Valid Usage

- VUID-VkWriteDescriptorSetPartitionedAccelerationStructureNV-accelerationStructureCount-10511
  `accelerationStructureCount` must be equal to `descriptorCount` in the extended structure

- VUID-VkWriteDescriptorSetPartitionedAccelerationStructureNV-pAccelerationStructures-10512
  Each entry in `pAccelerationStructures` must be a valid address of a PTLAS

Valid Usage (Implicit)

- VUID-VkWriteDescriptorSetPartitionedAccelerationStructureNV-sType-sType
  `sType` must be VK_STRUCTURE_TYPE_WRITE_DESCRIPTOR_SET_PARTITIONED_ACCELERATION_STRUCTURE_NV

- VUID-VkWriteDescriptorSetPartitionedAccelerationStructureNV-pAccelerationStructures-parameter
  `pAccelerationStructures` must be a valid pointer to an array of `accelerationStructureCount` or VK_NULL_HANDLE VkDeviceAddress values

- VUID-VkWriteDescriptorSetPartitionedAccelerationStructureNV-accelerationStructureCount-arraylength
  `accelerationStructureCount` must be greater than `0`

Structure Chaining

Extends the structure

  - VkWriteDescriptorSet

## See Also

VK_NV_partitioned_acceleration_structure, VkDeviceAddress, 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