VkDescriptorGetInfoEXT(3)

# VkDescriptorGetInfoEXT(3) Manual Page

## Name

VkDescriptorGetInfoEXT - Structure specifying parameters of descriptor to get

Loading… please wait.

## C Specification

Information about the descriptor to get is passed in a `VkDescriptorGetInfoEXT` structure:

Warning | This functionality is superseded by VK_EXT_descriptor_heap. See Legacy Functionality for more information.

    // Provided by VK_EXT_descriptor_buffer
    typedef struct VkDescriptorGetInfoEXT {
        VkStructureType        sType;
        const void*            pNext;
        VkDescriptorType       type;
        VkDescriptorDataEXT    data;
    } VkDescriptorGetInfoEXT;

## Members

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

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

- `type` is the type of descriptor to get.

- `data` is a VkDescriptorDataEXT union containing the information needed to get the descriptor.

## Description

Valid Usage

- VUID-VkDescriptorGetInfoEXT-type-08018
  `type` must not be VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER_DYNAMIC, VK_DESCRIPTOR_TYPE_STORAGE_BUFFER_DYNAMIC or VK_DESCRIPTOR_TYPE_INLINE_UNIFORM_BLOCK

- VUID-VkDescriptorGetInfoEXT-type-08019
  If `type` is VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER, the `pCombinedImageSampler->sampler` member of `data` must be a VkSampler created on `device`

- VUID-VkDescriptorGetInfoEXT-type-08020
  If `type` is VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER, the `pCombinedImageSampler->imageView` member of `data` must be a VkImageView created on `device`, or VK_NULL_HANDLE

- VUID-VkDescriptorGetInfoEXT-type-08021
  If `type` is VK_DESCRIPTOR_TYPE_INPUT_ATTACHMENT, the `pInputAttachmentImage->imageView` member of `data` must be a VkImageView created on `device`

- VUID-VkDescriptorGetInfoEXT-type-08022
  If `type` is VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE, and if `pSampledImage` is not `NULL`, the `pSampledImage->imageView` member of `data` must be a VkImageView created on `device`, or VK_NULL_HANDLE

- VUID-VkDescriptorGetInfoEXT-type-08023
  If `type` is VK_DESCRIPTOR_TYPE_STORAGE_IMAGE, and if `pStorageImage` is not `NULL`, the `pStorageImage->imageView` member of `data` must be a VkImageView created on `device`, or VK_NULL_HANDLE

- VUID-VkDescriptorGetInfoEXT-type-09427
  If `type` is VK_DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER, `pUniformBuffer` is not `NULL` , the number of texel buffer elements given by (⌊`pUniformBuffer->range` / (texel block size)⌋ × (texels per block)) where texel block size and texels per block are as defined in the Compatible Formats table for `pUniformBuffer->format`, must be less than or equal to `VkPhysicalDeviceLimits`::`maxTexelBufferElements`

- VUID-VkDescriptorGetInfoEXT-type-09428
  If `type` is VK_DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER, `pStorageBuffer` is not `NULL` , the number of texel buffer elements given by (⌊`pStorageBuffer->range` / (texel block size)⌋ × (texels per block)) where texel block size and texels per block are as defined in the Compatible Formats table for `pStorageBuffer->format`, must be less than or equal to `VkPhysicalDeviceLimits`::`maxTexelBufferElements`

- VUID-VkDescriptorGetInfoEXT-type-08028
  If `type` is VK_DESCRIPTOR_TYPE_ACCELERATION_STRUCTURE_KHR and `accelerationStructure` is not `0`, `accelerationStructure` must contain the address of a VkAccelerationStructureKHR created on `device`

- VUID-VkDescriptorGetInfoEXT-type-08029
  If `type` is VK_DESCRIPTOR_TYPE_ACCELERATION_STRUCTURE_NV and `accelerationStructure` is not `0`, `accelerationStructure` must contain the handle of a VkAccelerationStructureNV created on `device`, returned by vkGetAccelerationStructureHandleNV

- VUID-VkDescriptorGetInfoEXT-type-09701
  If `type` is VK_DESCRIPTOR_TYPE_TENSOR_ARM, a VkDescriptorGetTensorInfoARM structure must be included in the `pNext` chain and `data` is ignored

- VUID-VkDescriptorGetInfoEXT-type-12216
  If `type` is VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER and `pCombinedImageSampler->imageView` is not VK_NULL_HANDLE, the `pCombinedImageSampler->imageView` member of `data` must have been created with VK_IMAGE_USAGE_SAMPLED_BIT set

- VUID-VkDescriptorGetInfoEXT-type-12217
  If `type` is VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE, `pSampledImage` is not `NULL`, and `pSampledImage->imageView` is not VK_NULL_HANDLE, the `pSampledImage->imageView` member of `data` must have been created with VK_IMAGE_USAGE_SAMPLED_BIT set

- VUID-VkDescriptorGetInfoEXT-type-12218
  If `type` is VK_DESCRIPTOR_TYPE_STORAGE_IMAGE, `pStorageImage` is not `NULL`, and `pStorageImage->imageView` is not VK_NULL_HANDLE, the `pStorageImage->imageView` member of `data` must have been created with VK_IMAGE_USAGE_STORAGE_BIT set

- VUID-VkDescriptorGetInfoEXT-type-12219
  If `type` is VK_DESCRIPTOR_TYPE_INPUT_ATTACHMENT, the `pInputAttachmentImage->imageView` member of `data` must have been created with VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT set

- VUID-VkDescriptorGetInfoEXT-type-12220
  If `type` is VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER, `pUniformBuffer` is not `NULL` and `pUniformBuffer->address` is not zero, `pUniformBuffer->address` must be a device address allocated to the application from a buffer created with the VK_BUFFER_USAGE_UNIFORM_BUFFER_BIT usage flag set

- VUID-VkDescriptorGetInfoEXT-type-12221
  If `type` is VK_DESCRIPTOR_TYPE_STORAGE_BUFFER, `pStorageBuffer` is not `NULL` and `pStorageBuffer->address` is not zero, `pStorageBuffer->address` must be a device address allocated to the application from a buffer created with the VK_BUFFER_USAGE_STORAGE_BUFFER_BIT usage flag set

- VUID-VkDescriptorGetInfoEXT-type-12222
  If `type` is VK_DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER, `pUniformTexelBuffer` is not `NULL` and `pUniformTexelBuffer->address` is not zero, `pUniformTexelBuffer->address` must be a device address allocated to the application from a buffer created with the VK_BUFFER_USAGE_UNIFORM_TEXEL_BUFFER_BIT usage flag set

- VUID-VkDescriptorGetInfoEXT-type-12223
  If `type` is VK_DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER, `pStorageTexelBuffer` is not `NULL` and `pStorageTexelBuffer->address` is not zero, `pStorageTexelBuffer->address` must be a device address allocated to the application from a buffer created with the VK_BUFFER_USAGE_STORAGE_TEXEL_BUFFER_BIT usage flag set

- VUID-VkDescriptorGetInfoEXT-type-12265
  If `type` is VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER and `pUniformBuffer` is not `NULL`, `pUniformBuffer->address` must be aligned to `VkPhysicalDeviceLimits`::`minUniformBufferOffsetAlignment`

- VUID-VkDescriptorGetInfoEXT-type-12266
  If `type` is VK_DESCRIPTOR_TYPE_STORAGE_BUFFER and `pStorageBuffer` is not `NULL`, `pStorageBuffer->address` must be aligned to `VkPhysicalDeviceLimits`::`minStorageBufferOffsetAlignment`

- VUID-VkDescriptorGetInfoEXT-type-12269
  If `type` is VK_DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER, and `pUniformTexelBuffer` is not `NULL`, `pUniformTexelBuffer->address` must be a multiple of the effective alignment requirement as determined by `minTexelBufferOffsetAlignment`

- VUID-VkDescriptorGetInfoEXT-type-12270
  If `type` is VK_DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER, the and `pStorageTexelBuffer` is not `NULL`, `pStorageTexelBuffer->address` must be a multiple of the effective alignment requirement as determined by `minTexelBufferOffsetAlignment`

Valid Usage (Implicit)

- VUID-VkDescriptorGetInfoEXT-sType-sType
  `sType` must be VK_STRUCTURE_TYPE_DESCRIPTOR_GET_INFO_EXT

- VUID-VkDescriptorGetInfoEXT-pNext-pNext
  `pNext` must be `NULL` or a pointer to a valid instance of VkDescriptorGetTensorInfoARM

- VUID-VkDescriptorGetInfoEXT-sType-unique
  The `sType` value of each structure in the `pNext` chain must be unique

- VUID-VkDescriptorGetInfoEXT-type-parameter
  `type` must be a valid VkDescriptorType value

- VUID-VkDescriptorGetInfoEXT-pSampler-parameter
  If `type` is VK_DESCRIPTOR_TYPE_SAMPLER, the `pSampler` member of `data` must be a valid pointer to a valid VkSampler handle

- VUID-VkDescriptorGetInfoEXT-pCombinedImageSampler-parameter
  If `type` is VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER, the `pCombinedImageSampler` member of `data` must be a valid pointer to a valid VkDescriptorImageInfo structure

- VUID-VkDescriptorGetInfoEXT-pInputAttachmentImage-parameter
  If `type` is VK_DESCRIPTOR_TYPE_INPUT_ATTACHMENT, the `pInputAttachmentImage` member of `data` must be a valid pointer to a valid VkDescriptorImageInfo structure

- VUID-VkDescriptorGetInfoEXT-pSampledImage-parameter
  If `type` is VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE, and if `pSampledImage` is not `NULL`, the `pSampledImage` member of `data` must be a valid pointer to a valid VkDescriptorImageInfo structure

- VUID-VkDescriptorGetInfoEXT-pStorageImage-parameter
  If `type` is VK_DESCRIPTOR_TYPE_STORAGE_IMAGE, and if `pStorageImage` is not `NULL`, the `pStorageImage` member of `data` must be a valid pointer to a valid VkDescriptorImageInfo structure

- VUID-VkDescriptorGetInfoEXT-pUniformTexelBuffer-parameter
  If `type` is VK_DESCRIPTOR_TYPE_UNIFORM_TEXEL_BUFFER, and if `pUniformTexelBuffer` is not `NULL`, the `pUniformTexelBuffer` member of `data` must be a valid pointer to a valid VkDescriptorAddressInfoEXT structure

- VUID-VkDescriptorGetInfoEXT-pStorageTexelBuffer-parameter
  If `type` is VK_DESCRIPTOR_TYPE_STORAGE_TEXEL_BUFFER, and if `pStorageTexelBuffer` is not `NULL`, the `pStorageTexelBuffer` member of `data` must be a valid pointer to a valid VkDescriptorAddressInfoEXT structure

- VUID-VkDescriptorGetInfoEXT-pUniformBuffer-parameter
  If `type` is VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER, and if `pUniformBuffer` is not `NULL`, the `pUniformBuffer` member of `data` must be a valid pointer to a valid VkDescriptorAddressInfoEXT structure

- VUID-VkDescriptorGetInfoEXT-pStorageBuffer-parameter
  If `type` is VK_DESCRIPTOR_TYPE_STORAGE_BUFFER, and if `pStorageBuffer` is not `NULL`, the `pStorageBuffer` member of `data` must be a valid pointer to a valid VkDescriptorAddressInfoEXT structure

- VUID-VkDescriptorGetInfoEXT-accelerationStructure-parameter
  If `type` is VK_DESCRIPTOR_TYPE_ACCELERATION_STRUCTURE_KHR or VK_DESCRIPTOR_TYPE_ACCELERATION_STRUCTURE_NV, the `accelerationStructure` member of `data` must be a valid VkDeviceAddress value

## See Also

VK_EXT_descriptor_buffer, VkDescriptorDataEXT, VkDescriptorType, VkStructureType, vkGetDescriptorEXT

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