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;
sType
is a VkStructureType value identifying this structure.pNext
isNULL
or a pointer to a structure extending this structure.pCreateInfo
is a pointer to a VkImageCreateInfo structure containing parameters affecting creation of the image to query.pSubresource
pSubresource 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