Structures

VkImageConstraintsInfoFUCHSIA

Structure of image-based buffer collection constraints

The VkImageConstraintsInfoFUCHSIA structure is defined as:

typedef struct VkImageConstraintsInfoFUCHSIA {
    VkStructureType sType;
    const void* pNext;
    uint32_t formatConstraintsCount;
    const VkImageFormatConstraintsInfoFUCHSIA* pFormatConstraints;
    VkBufferCollectionConstraintsInfoFUCHSIA bufferCollectionConstraints;
    VkImageConstraintsInfoFlagsFUCHSIA flags;
} VkImageConstraintsInfoFUCHSIA;
  • sType is a VkStructureType value identifying this structure.
  • pNext is NULL or a pointer to a structure extending this structure.
  • formatConstraintsCount is the number of elements in pFormatConstraints.
  • pFormatConstraints is a pointer to an array of VkImageFormatConstraintsInfoFUCHSIA structures of size formatConstraintsCount that is used to further constrain buffer collection format selection for image-based buffer collections.
  • bufferCollectionConstraints is a VkBufferCollectionConstraintsInfoFUCHSIA structure used to supply parameters for the negotiation and allocation for buffer-based buffer collections.
  • flags is a VkImageConstraintsInfoFlagBitsFUCHSIA value specifying hints about the type of memory Sysmem should allocate for the buffer collection.

Valid Usage

VUID-VkImageConstraintsInfoFUCHSIA-pFormatConstraints-06395

All elements of pFormatConstraints must have at least one bit set in its VkImageFormatConstraintsInfoFUCHSIA::requiredFormatFeatures

VUID-VkImageConstraintsInfoFUCHSIA-pFormatConstraints-06396

If pFormatConstraints→imageCreateInfo→usage contains VK_IMAGE_USAGE_SAMPLED_BIT, then pFormatConstraints→requiredFormatFeatures must contain VK_FORMAT_FEATURE_SAMPLED_IMAGE_BIT

VUID-VkImageConstraintsInfoFUCHSIA-pFormatConstraints-06397

If pFormatConstraints→imageCreateInfo→usage contains VK_IMAGE_USAGE_STORAGE_BIT, then pFormatConstraints→requiredFormatFeatures must contain VK_FORMAT_FEATURE_STORAGE_IMAGE_BIT

VUID-VkImageConstraintsInfoFUCHSIA-pFormatConstraints-06398

If pFormatConstraints→imageCreateInfo→usage contains VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT, then pFormatConstraints→requiredFormatFeatures must contain VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT

VUID-VkImageConstraintsInfoFUCHSIA-pFormatConstraints-06399

If pFormatConstraints→imageCreateInfo→usage contains VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT, then pFormatConstraints→requiredFormatFeatures must contain VK_FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT

VUID-VkImageConstraintsInfoFUCHSIA-pFormatConstraints-06400

If pFormatConstraints→imageCreateInfo→usage contains VK_IMAGE_USAGE_INPUT_ATTACHMENT_BIT, then pFormatConstraints→requiredFormatFeatures must contain at least one of VK_FORMAT_FEATURE_COLOR_ATTACHMENT_BIT or VK_FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT

VUID-VkImageConstraintsInfoFUCHSIA-attachmentFragmentShadingRate-06401

If the attachmentFragmentShadingRate feature is enabled, and pFormatConstraints→imageCreateInfo→usage contains VK_IMAGE_USAGE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR, then pFormatConstraints→requiredFormatFeatures must contain VK_FORMAT_FEATURE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR

Valid Usage (Implicit)

VUID-VkImageConstraintsInfoFUCHSIA-sType-sType

sType must be VK_STRUCTURE_TYPE_IMAGE_CONSTRAINTS_INFO_FUCHSIA

VUID-VkImageConstraintsInfoFUCHSIA-pFormatConstraints-parameter

pFormatConstraints must be a valid pointer to an array of formatConstraintsCount valid VkImageFormatConstraintsInfoFUCHSIA structures