VkDeviceImageSubresourceInfo
The VkDeviceImageSubresourceInfo structure is defined as:
typedef struct VkDeviceImageSubresourceInfo {
VkStructureType sType;
const void* pNext;
const VkImageCreateInfo* pCreateInfo;
const VkImageSubresource2* pSubresource;
} VkDeviceImageSubresourceInfo;
or the equivalent
typedef VkDeviceImageSubresourceInfo VkDeviceImageSubresourceInfoKHR;
sTypeis a VkStructureType value identifying this structure.pNextisNULLor a pointer to a structure extending this structure.pCreateInfois a pointer to a VkImageCreateInfo structure containing parameters affecting creation of the image to query.pSubresourcepSubresource is a pointer to a VkImageSubresource2 structure selecting a specific image subresource for the query.
Valid Usage
VUID-VkDeviceImageSubresourceInfo-aspectMask-00997
The aspectMask member of pSubresource must only have a
single bit set
VUID-VkDeviceImageSubresourceInfo-mipLevel-01716
The mipLevel member of pSubresource must be less than the
mipLevels specified in pCreateInfo
VUID-VkDeviceImageSubresourceInfo-arrayLayer-01717
The arrayLayer member of pSubresource must be less than the
arrayLayers specified in pCreateInfo
VUID-VkDeviceImageSubresourceInfo-format-08886
If format of the image is a color format
that is not a multi-planar format,
and tiling of the pCreateInfo is
VK_IMAGE_TILING_LINEAR or VK_IMAGE_TILING_OPTIMAL, the
aspectMask member of pSubresource must be
VK_IMAGE_ASPECT_COLOR_BIT
VUID-VkDeviceImageSubresourceInfo-format-04462
If format of the pCreateInfo has a depth component, the
aspectMask member of pSubresource must contain
VK_IMAGE_ASPECT_DEPTH_BIT
VUID-VkDeviceImageSubresourceInfo-format-04463
If format of the pCreateInfo has a stencil component, the
aspectMask member of pSubresource must contain
VK_IMAGE_ASPECT_STENCIL_BIT
VUID-VkDeviceImageSubresourceInfo-format-04464
If format of the pCreateInfo does not contain a stencil or
depth component, the aspectMask member of pSubresource must
not contain VK_IMAGE_ASPECT_DEPTH_BIT or
VK_IMAGE_ASPECT_STENCIL_BIT
VUID-VkDeviceImageSubresourceInfo-tiling-08717
If the tiling of the pCreateInfo is
VK_IMAGE_TILING_LINEAR and has a multi-planar format, then the aspectMask member of
pSubresource must be a single valid
multi-planar aspect mask bit
Valid Usage (Implicit)
VUID-VkDeviceImageSubresourceInfo-sType-sType
sType must be VK_STRUCTURE_TYPE_DEVICE_IMAGE_SUBRESOURCE_INFO
VUID-VkDeviceImageSubresourceInfo-pNext-pNext
pNext must be NULL
VUID-VkDeviceImageSubresourceInfo-pCreateInfo-parameter
pCreateInfo must be a valid pointer to a valid VkImageCreateInfo structure
VUID-VkDeviceImageSubresourceInfo-pSubresource-parameter
pSubresource must be a valid pointer to a valid VkImageSubresource2 structure