Structures
VkImageFormatListCreateInfo
Specify that an image can: be used with a particular set of formats
If the pNext
chain of VkImageCreateInfo includes a
VkImageFormatListCreateInfo
structure, then that structure contains a
list of all formats that can be used when creating views of this image.
The VkImageFormatListCreateInfo
structure is defined as:
typedef struct VkImageFormatListCreateInfo {
VkStructureType sType;
const void* pNext;
uint32_t viewFormatCount;
const VkFormat* pViewFormats;
} VkImageFormatListCreateInfo;
or the equivalent
typedef VkImageFormatListCreateInfo VkImageFormatListCreateInfoKHR;
sType
is a VkStructureType value identifying this structure.pNext
isNULL
or a pointer to a structure extending this structure.viewFormatCount
is the number of entries in thepViewFormats
array.pViewFormats
is a pointer to an array of VkFormat values specifying all formats which can be used when creating views of this image.
If viewFormatCount
is zero, pViewFormats
is ignored and the
image is created as if the VkImageFormatListCreateInfo
structure were
not included in the pNext
chain of VkImageCreateInfo.
Valid Usage
VUID-VkImageFormatListCreateInfo-viewFormatCount-09540
If viewFormatCount
is not 0, each element of pViewFormats
must not be VK_FORMAT_UNDEFINED
Valid Usage (Implicit)
VUID-VkImageFormatListCreateInfo-sType-sType
sType
must be VK_STRUCTURE_TYPE_IMAGE_FORMAT_LIST_CREATE_INFO
VUID-VkImageFormatListCreateInfo-pViewFormats-parameter
If viewFormatCount
is not 0
, pViewFormats
must be a valid pointer to an array of viewFormatCount
valid VkFormat values