VkShaderDescriptorSetAndBindingMappingInfoEXT(3)

# VkShaderDescriptorSetAndBindingMappingInfoEXT(3) Manual Page

## Name

VkShaderDescriptorSetAndBindingMappingInfoEXT - Structure specifying mappings from shader resources to descriptor heaps

## C Specification

The `VkShaderDescriptorSetAndBindingMappingInfoEXT` structure is defined as:

    // Provided by VK_EXT_descriptor_heap
    typedef struct VkShaderDescriptorSetAndBindingMappingInfoEXT {
        VkStructureType                               sType;
        const void*                                   pNext;
        uint32_t                                      mappingCount;
        const VkDescriptorSetAndBindingMappingEXT*    pMappings;
    } VkShaderDescriptorSetAndBindingMappingInfoEXT;

## Members

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

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

- `mappingCount` is the number of elements in `pMappings`.

- `pMappings` is a pointer to an array of VkDescriptorSetAndBindingMappingEXT structures specifying mappings for a set of descriptors

## Description

Including this structure in the `pNext` chain of VkPipelineShaderStageCreateInfo will set mappings for the shader defined by that structure. Similarly, including this structure in the `pNext` chain of a VkShaderCreateInfoEXT with a `codeType` of VK_SHADER_CODE_TYPE_SPIRV_EXT, will set mappings for that shader.

If this structure is not present, it is equivalent to setting `mappingCount` to 0.

Valid Usage

- VUID-VkShaderDescriptorSetAndBindingMappingInfoEXT-pMappings-11244
  Any two elements of `pMappings` must not have the same value of `descriptorSet`, an overlapping range specified by `firstBinding` and `bindingCount`, and any overlapping bits in `resourceMask`

Valid Usage (Implicit)

- VUID-VkShaderDescriptorSetAndBindingMappingInfoEXT-sType-sType
  `sType` must be VK_STRUCTURE_TYPE_SHADER_DESCRIPTOR_SET_AND_BINDING_MAPPING_INFO_EXT

- VUID-VkShaderDescriptorSetAndBindingMappingInfoEXT-pMappings-parameter
  If `mappingCount` is not `0`, `pMappings` must be a valid pointer to an array of `mappingCount` valid VkDescriptorSetAndBindingMappingEXT structures

Structure Chaining

Extends the structures

  - VkPipelineShaderStageCreateInfo

  - VkShaderCreateInfoEXT

## See Also

VK_EXT_descriptor_heap, VkDescriptorSetAndBindingMappingEXT, 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