VkImageDescriptorInfoEXT(3)

# VkImageDescriptorInfoEXT(3) Manual Page

## Name

VkImageDescriptorInfoEXT - Structure describing an image descriptor created from an image

Loading… please wait.

## C Specification

`VkImageDescriptorInfoEXT` is defined as:

    // Provided by VK_EXT_descriptor_heap
    typedef struct VkImageDescriptorInfoEXT {
        VkStructureType                 sType;
        const void*                     pNext;
        const VkImageViewCreateInfo*    pView;
        VkImageLayout                   layout;
    } VkImageDescriptorInfoEXT;

## Members

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

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

- `pView` is an VkImageViewCreateInfo describing the descriptor.

- `layout` is the VkImageLayout that the image view will be in when accessed as a descriptor.

## Description

Valid Usage

- VUID-VkImageDescriptorInfoEXT-pView-11426
  `pView->viewType` must not be VK_IMAGE_VIEW_TYPE_2D_ARRAY if `pView->image` was created with an `imageType` of VK_IMAGE_TYPE_3D

- VUID-VkImageDescriptorInfoEXT-pView-11427
  If `pView->viewType` is VK_IMAGE_VIEW_TYPE_2D and `pView->image` was created with an `imageType` of VK_IMAGE_TYPE_3D, `pView->image` must have been created with VK_IMAGE_CREATE_2D_VIEW_COMPATIBLE_BIT_EXT set

- VUID-VkImageDescriptorInfoEXT-layout-11219
  `layout` must be VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL, VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL, VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL, VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL, VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL, VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL, VK_IMAGE_LAYOUT_READ_ONLY_OPTIMAL, VK_IMAGE_LAYOUT_SHARED_PRESENT_KHR, VK_IMAGE_LAYOUT_RENDERING_LOCAL_READ_KHR, VK_IMAGE_LAYOUT_ATTACHMENT_FEEDBACK_LOOP_OPTIMAL_EXT, or VK_IMAGE_LAYOUT_GENERAL

- VUID-VkImageDescriptorInfoEXT-layout-11221
  If `layout` is VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL, VK_IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL, VK_IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL, VK_IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL, or VK_IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL, then `pView->aspectMask` must not include VK_IMAGE_ASPECT_COLOR_BIT

- VUID-VkImageDescriptorInfoEXT-pView-11430
  If `pView->image` is a depth/stencil image, `pView->subresourceRange.aspectMask` must include either VK_IMAGE_ASPECT_DEPTH_BIT or VK_IMAGE_ASPECT_STENCIL_BIT but not both

Valid Usage (Implicit)

- VUID-VkImageDescriptorInfoEXT-sType-sType
  `sType` must be VK_STRUCTURE_TYPE_IMAGE_DESCRIPTOR_INFO_EXT

- VUID-VkImageDescriptorInfoEXT-pNext-pNext
  `pNext` must be `NULL`

- VUID-VkImageDescriptorInfoEXT-pView-parameter
  `pView` must be a valid pointer to a valid VkImageViewCreateInfo structure

- VUID-VkImageDescriptorInfoEXT-layout-parameter
  `layout` must be a valid VkImageLayout value

## See Also

VK_EXT_descriptor_heap, VkImageLayout, VkImageViewCreateInfo, VkResourceDescriptorDataEXT, 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