VkImagePlaneMemoryRequirementsInfo
To determine the memory requirements for a plane of a disjoint image, add a
VkImagePlaneMemoryRequirementsInfo
structure to the pNext
chain
of the VkImageMemoryRequirementsInfo2
structure.
The VkImagePlaneMemoryRequirementsInfo
structure is defined as:
typedef struct VkImagePlaneMemoryRequirementsInfo {
VkStructureType sType;
const void* pNext;
VkImageAspectFlagBits planeAspect;
} VkImagePlaneMemoryRequirementsInfo;
or the equivalent
typedef VkImagePlaneMemoryRequirementsInfo VkImagePlaneMemoryRequirementsInfoKHR;
sType
is a VkStructureType value identifying this structure.pNext
isNULL
or a pointer to a structure extending this structure.planeAspect
is a VkImageAspectFlagBits value specifying the aspect corresponding to the image plane to query.
Valid Usage
VUID-VkImagePlaneMemoryRequirementsInfo-planeAspect-02281
If the image’s tiling
is VK_IMAGE_TILING_LINEAR
or
VK_IMAGE_TILING_OPTIMAL
, then planeAspect
must be a single
valid multi-planar aspect mask bit
VUID-VkImagePlaneMemoryRequirementsInfo-planeAspect-02282
If the image’s tiling
is
VK_IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT
, then planeAspect
must be a single valid memory plane for the image (that is,
aspectMask
must specify a plane index that is less than the
VkDrmFormatModifierPropertiesEXT::drmFormatModifierPlaneCount
associated with the image’s format
and
VkImageDrmFormatModifierPropertiesEXT::drmFormatModifier
)
Valid Usage (Implicit)
VUID-VkImagePlaneMemoryRequirementsInfo-sType-sType
sType
must be VK_STRUCTURE_TYPE_IMAGE_PLANE_MEMORY_REQUIREMENTS_INFO
VUID-VkImagePlaneMemoryRequirementsInfo-planeAspect-parameter
planeAspect
must be a valid VkImageAspectFlagBits value