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 is NULL or a pointer to a structure extending this structure.
  • viewFormatCount is the number of entries in the pViewFormats 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 pViewFormatsmust 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