vkCreateRenderPass2 - Create a new render pass object

Description

This command is functionally identical to createRenderPass, but includes extensible sub-structures that include sType and pNext parameters, allowing them to be more easily extended.

Valid Usage (Implicit)

• device must be a valid Device handle

• pCreateInfo must be a valid pointer to a valid RenderPassCreateInfo2 structure
• If pAllocator is not NULL, pAllocator must be a valid pointer to a valid AllocationCallbacks structure
• pRenderPass must be a valid pointer to a RenderPass handle

Return Codes

Success

• SUCCESS

Failure

• ERROR_OUT_OF_HOST_MEMORY
• ERROR_OUT_OF_DEVICE_MEMORY

See Also

VK_KHR_create_renderpass2, VK_VERSION_1_2, AllocationCallbacks, Device, RenderPass, RenderPassCreateInfo2

vkCmdBeginRenderPass2 - Begin a new render pass

Description

After beginning a render pass instance, the command buffer is ready to record the commands for the first subpass of that render pass.

Valid Usage

• Both the framebuffer and renderPass members of pRenderPassBegin must have been created on the same Device that commandBuffer was allocated on

• If any of the initialLayout or finalLayout member of the AttachmentDescription structures or the layout member of the AttachmentReference structures specified when creating the render pass specified in the renderPass member of pRenderPassBegin is IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL then the corresponding attachment image view of the framebuffer specified in the framebuffer member of pRenderPassBegin must have been created with a usage value including IMAGE_USAGE_COLOR_ATTACHMENT_BIT
• If any of the initialLayout or finalLayout member of the AttachmentDescription structures or the layout member of the AttachmentReference structures specified when creating the render pass specified in the renderPass member of pRenderPassBegin is IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL, IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL, IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL, or IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL then the corresponding attachment image view of the framebuffer specified in the framebuffer member of pRenderPassBegin must have been created with a usage value including IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT
• If any of the initialLayout or finalLayout member of the AttachmentDescription structures or the layout member of the AttachmentReference structures specified when creating the render pass specified in the renderPass member of pRenderPassBegin is IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL, or IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL, IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL, or IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL then the corresponding attachment image view of the framebuffer specified in the framebuffer member of pRenderPassBegin must have been created with a usage value including IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT
• If any of the stencilInitialLayout or stencilFinalLayout member of the AttachmentDescriptionStencilLayout structures or the stencilLayout member of the AttachmentReferenceStencilLayout structures specified when creating the render pass specified in the renderPass member of pRenderPassBegin is IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL, or IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL then the corresponding attachment image view of the framebuffer specified in the framebuffer member of pRenderPassBegin must have been created with a usage value including IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT
• If any of the initialLayout or finalLayout member of the AttachmentDescription structures or the layout member of the AttachmentReference structures specified when creating the render pass specified in the renderPass member of pRenderPassBegin is IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL then the corresponding attachment image view of the framebuffer specified in the framebuffer member of pRenderPassBegin must have been created with a usage value including IMAGE_USAGE_SAMPLED_BIT or IMAGE_USAGE_INPUT_ATTACHMENT_BIT
• If any of the initialLayout or finalLayout member of the AttachmentDescription structures or the layout member of the AttachmentReference structures specified when creating the render pass specified in the renderPass member of pRenderPassBegin is IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL then the corresponding attachment image view of the framebuffer specified in the framebuffer member of pRenderPassBegin must have been created with a usage value including IMAGE_USAGE_TRANSFER_SRC_BIT
• If any of the initialLayout or finalLayout member of the AttachmentDescription structures or the layout member of the AttachmentReference structures specified when creating the render pass specified in the renderPass member of pRenderPassBegin is IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL then the corresponding attachment image view of the framebuffer specified in the framebuffer member of pRenderPassBegin must have been created with a usage value including IMAGE_USAGE_TRANSFER_DST_BIT
• If the initialLayout member of any of the AttachmentDescription structures specified when creating the render pass specified in the renderPass member of pRenderPassBegin is not IMAGE_LAYOUT_UNDEFINED, then each such initialLayout must be equal to the current layout of the corresponding attachment image subresource of the framebuffer specified in the framebuffer member of pRenderPassBegin
• The srcStageMask members of any element of the pDependencies member of RenderPassCreateInfo used to create renderPass must be supported by the capabilities of the queue family identified by the queueFamilyIndex member of the CommandPoolCreateInfo used to create the command pool which commandBuffer was allocated from
• The dstStageMask members of any element of the pDependencies member of RenderPassCreateInfo used to create renderPass must be supported by the capabilities of the queue family identified by the queueFamilyIndex member of the CommandPoolCreateInfo used to create the command pool which commandBuffer was allocated from
• For any attachment in framebuffer that is used by renderPass and is bound to memory locations that are also bound to another attachment used by renderPass, and if at least one of those uses causes either attachment to be written to, both attachments must have had the ATTACHMENT_DESCRIPTION_MAY_ALIAS_BIT set
• If any attachments specified in framebuffer are used by renderPass and are bound to overlapping memory locations, there must be only one that is used as a color attachment, depth/stencil, or resolve attachment in any subpass
• If any of the initialLayout or finalLayout member of the AttachmentDescription structures or the layout member of the AttachmentReference structures specified when creating the render pass specified in the renderPass member of pRenderPassBegin is IMAGE_LAYOUT_ATTACHMENT_FEEDBACK_LOOP_OPTIMAL_EXT then the corresponding attachment image view of the framebuffer specified in the framebuffer member of pRenderPassBegin must have been created with a usage value including either the IMAGE_USAGE_COLOR_ATTACHMENT_BIT or IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT and either the IMAGE_USAGE_INPUT_ATTACHMENT_BIT or IMAGE_USAGE_SAMPLED_BIT usage bits
• If any of the initialLayout or finalLayout member of the AttachmentDescription structures or the layout member of the AttachmentReference structures specified when creating the render pass specified in the renderPass member of pRenderPassBegin is IMAGE_LAYOUT_ATTACHMENT_FEEDBACK_LOOP_OPTIMAL_EXT then the corresponding attachment image view of the framebuffer specified in the framebuffer member of pRenderPassBegin must have been created with a usage value the IMAGE_USAGE_ATTACHMENT_FEEDBACK_LOOP_BIT_EXT usage bit

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• pRenderPassBegin must be a valid pointer to a valid RenderPassBeginInfo structure
• pSubpassBeginInfo must be a valid pointer to a valid SubpassBeginInfo structure
• commandBuffer must be in the recording state
• The CommandPool that commandBuffer was allocated from must support graphics operations
• This command must only be called outside of a render pass instance
• This command must only be called outside of a video coding scope
• commandBuffer must be a primary CommandBuffer

Host Synchronization

• Host access to commandBuffer must be externally synchronized

• Host access to the CommandPool that commandBuffer was allocated from must be externally synchronized

Command Properties

'

See Also

VK_KHR_create_renderpass2, VK_VERSION_1_2, CommandBuffer, RenderPassBeginInfo, SubpassBeginInfo

This function will call the supplied action between calls to cmdBeginRenderPass2 and cmdEndRenderPass2

Note that cmdEndRenderPass2 is *not* called if an exception is thrown by the inner action.

vkCmdNextSubpass2 - Transition to the next subpass of a render pass

Description

cmdNextSubpass2 is semantically identical to cmdNextSubpass, except that it is extensible, and that contents is provided as part of an extensible structure instead of as a flat parameter.

Valid Usage

• The current subpass index must be less than the number of subpasses in the render pass minus one

• This command must not be recorded when transform feedback is active

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• pSubpassBeginInfo must be a valid pointer to a valid SubpassBeginInfo structure
• pSubpassEndInfo must be a valid pointer to a valid SubpassEndInfo structure
• commandBuffer must be in the recording state
• The CommandPool that commandBuffer was allocated from must support graphics operations
• This command must only be called inside of a render pass instance
• This command must only be called outside of a video coding scope
• commandBuffer must be a primary CommandBuffer

Host Synchronization

• Host access to commandBuffer must be externally synchronized

• Host access to the CommandPool that commandBuffer was allocated from must be externally synchronized

Command Properties

'

See Also

VK_KHR_create_renderpass2, VK_VERSION_1_2, CommandBuffer, SubpassBeginInfo, SubpassEndInfo

vkCmdEndRenderPass2 - End the current render pass

Description

cmdEndRenderPass2 is semantically identical to cmdEndRenderPass, except that it is extensible.

Valid Usage

• The current subpass index must be equal to the number of subpasses in the render pass minus one

• This command must not be recorded when transform feedback is active
• The current render pass instance must not have been begun with cmdBeginRendering
• If cmdBeginQuery* was called within a subpass of the render pass, the corresponding cmdEndQuery* must have been called subsequently within the same subpass

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• pSubpassEndInfo must be a valid pointer to a valid SubpassEndInfo structure
• commandBuffer must be in the recording state
• The CommandPool that commandBuffer was allocated from must support graphics operations
• This command must only be called inside of a render pass instance
• This command must only be called outside of a video coding scope
• commandBuffer must be a primary CommandBuffer

Host Synchronization

• Host access to commandBuffer must be externally synchronized

• Host access to the CommandPool that commandBuffer was allocated from must be externally synchronized

Command Properties

'

See Also

VK_KHR_create_renderpass2, VK_VERSION_1_2, CommandBuffer, SubpassEndInfo

VkAttachmentDescription2 - Structure specifying an attachment description

Description

Parameters defined by this structure with the same name as those in AttachmentDescription have the identical effect to those parameters.

If the separateDepthStencilLayouts feature is enabled, and format is a depth/stencil format, initialLayout and finalLayout can be set to a layout that only specifies the layout of the depth aspect.

If the pNext chain includes a AttachmentDescriptionStencilLayout structure, then the stencilInitialLayout and stencilFinalLayout members specify the initial and final layouts of the stencil aspect of a depth/stencil format, and initialLayout and finalLayout only apply to the depth aspect. For depth-only formats, the AttachmentDescriptionStencilLayout structure is ignored. For stencil-only formats, the initial and final layouts of the stencil aspect are taken from the AttachmentDescriptionStencilLayout structure if present, or initialLayout and finalLayout if not present.

If format is a depth/stencil format, and either initialLayout or finalLayout does not specify a layout for the stencil aspect, then the application must specify the initial and final layouts of the stencil aspect by including a AttachmentDescriptionStencilLayout structure in the pNext chain.

loadOp and storeOp are ignored for fragment shading rate attachments. No access to the shading rate attachment is performed in loadOp and storeOp. Instead, access to ACCESS_FRAGMENT_SHADING_RATE_ATTACHMENT_READ_BIT_KHR is performed as fragments are rasterized.

Valid Usage

• If format includes a color or depth component and loadOp is ATTACHMENT_LOAD_OP_LOAD, then initialLayout must not be IMAGE_LAYOUT_UNDEFINED

• finalLayout must not be IMAGE_LAYOUT_UNDEFINED or IMAGE_LAYOUT_PREINITIALIZED
• If format is a color format, initialLayout must not be IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL or IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL
• If format is a depth/stencil format, initialLayout must not be IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL
• If format is a color format, finalLayout must not be IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL or IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL
• If format is a depth/stencil format, finalLayout must not be IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL
• If format is a color format, initialLayout must not be IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL or IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL
• If format is a color format, finalLayout must not be IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL or IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL
• If the separateDepthStencilLayouts feature is not enabled, initialLayout must not be IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL, IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL, IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL, or IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL,
• If the separateDepthStencilLayouts feature is not enabled, finalLayout must not be IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL, IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL, IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL, or IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL,
• If format is a color format, initialLayout must not be IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL, IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL, IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL, or IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL
• If format is a color format, finalLayout must not be IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL, IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL, IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL, or IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL
• If format is a depth/stencil format which includes both depth and stencil components, initialLayout must not be IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL or IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL
• If format is a depth/stencil format which includes both depth and stencil components, finalLayout must not be IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL or IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL
• If format is a depth/stencil format which includes only the depth component, initialLayout must not be IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL or IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL
• If format is a depth/stencil format which includes only the depth component, finalLayout must not be IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL or IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL
• If the synchronization2 feature is not enabled, initialLayout must not be IMAGE_LAYOUT_ATTACHMENT_OPTIMAL_KHR or IMAGE_LAYOUT_READ_ONLY_OPTIMAL_KHR
• If the synchronization2 feature is not enabled, finalLayout must not be IMAGE_LAYOUT_ATTACHMENT_OPTIMAL_KHR or IMAGE_LAYOUT_READ_ONLY_OPTIMAL_KHR
• If the attachmentFeedbackLoopLayout feature is not enabled, initialLayout must not be IMAGE_LAYOUT_ATTACHMENT_FEEDBACK_LOOP_OPTIMAL_EXT
• If the attachmentFeedbackLoopLayout feature is not enabled, finalLayout must not be IMAGE_LAYOUT_ATTACHMENT_FEEDBACK_LOOP_OPTIMAL_EXT
• samples must be a bit value that is set in imageCreateSampleCounts (as defined in Image Creation Limits) for the given format
• If the pNext chain does not include a AttachmentDescriptionStencilLayout structure, format includes a stencil component, and stencilLoadOp is ATTACHMENT_LOAD_OP_LOAD, then initialLayout must not be IMAGE_LAYOUT_UNDEFINED
• If the pNext chain includes a AttachmentDescriptionStencilLayout structure, format includes a stencil component, and stencilLoadOp is ATTACHMENT_LOAD_OP_LOAD, then AttachmentDescriptionStencilLayout::stencilInitialLayout must not be IMAGE_LAYOUT_UNDEFINED
• If format is a depth/stencil format which includes both depth and stencil components, and initialLayout is IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL or IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL, the pNext chain must include a AttachmentDescriptionStencilLayout structure
• If format is a depth/stencil format which includes both depth and stencil components, and finalLayout is IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL or IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL, the pNext chain must include a AttachmentDescriptionStencilLayout structure
• If the pNext chain does not include a AttachmentDescriptionStencilLayout structure and format only includes a stencil component, initialLayout must not be IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL or IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL
• If the pNext chain does not include a AttachmentDescriptionStencilLayout structure and format only includes a stencil component, finalLayout must not be IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL or IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL
• If externalFormatResolve is not enabled, format must not be FORMAT_UNDEFINED
• If format is FORMAT_UNDEFINED, there must be a ExternalFormatANDROID structure in the pNext chain with a externalFormat that is not equal to 0

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_ATTACHMENT_DESCRIPTION_2

• Each pNext member of any structure (including this one) in the pNext chain must be either NULL or a pointer to a valid instance of AttachmentDescriptionStencilLayout or ExternalFormatANDROID
• The sType value of each struct in the pNext chain must be unique
• flags must be a valid combination of AttachmentDescriptionFlagBits values
• format must be a valid Format value
• samples must be a valid SampleCountFlagBits value
• loadOp must be a valid AttachmentLoadOp value
• storeOp must be a valid AttachmentStoreOp value
• stencilLoadOp must be a valid AttachmentLoadOp value
• stencilStoreOp must be a valid AttachmentStoreOp value
• initialLayout must be a valid ImageLayout value
• finalLayout must be a valid ImageLayout value

See Also

VK_KHR_create_renderpass2, VK_VERSION_1_2, AttachmentDescriptionFlags, AttachmentLoadOp, AttachmentStoreOp, Format, ImageLayout, RenderPassCreateInfo2, SampleCountFlagBits, StructureType

VkAttachmentReference2 - Structure specifying an attachment reference

Description

Parameters defined by this structure with the same name as those in AttachmentReference have the identical effect to those parameters.

aspectMask is ignored when this structure is used to describe anything other than an input attachment reference.

If the separateDepthStencilLayouts feature is enabled, and attachment has a depth/stencil format, layout can be set to a layout that only specifies the layout of the depth aspect.

If layout only specifies the layout of the depth aspect of the attachment, the layout of the stencil aspect is specified by the stencilLayout member of a AttachmentReferenceStencilLayout structure included in the pNext chain. Otherwise, layout describes the layout for all relevant image aspects.

Valid Usage

• If attachment is not ATTACHMENT_UNUSED, layout must not be IMAGE_LAYOUT_UNDEFINED, IMAGE_LAYOUT_PREINITIALIZED, or IMAGE_LAYOUT_PRESENT_SRC_KHR

• If the separateDepthStencilLayouts feature is not enabled, and attachment is not ATTACHMENT_UNUSED, layout must not be IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL, IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL, IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL, or IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL,
• If the synchronization2 feature is not enabled, layout must not be IMAGE_LAYOUT_ATTACHMENT_OPTIMAL_KHR or IMAGE_LAYOUT_READ_ONLY_OPTIMAL_KHR
• If the attachmentFeedbackLoopLayout feature is not enabled, layout must not be IMAGE_LAYOUT_ATTACHMENT_FEEDBACK_LOOP_OPTIMAL_EXT

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_ATTACHMENT_REFERENCE_2

• pNext must be NULL or a pointer to a valid instance of AttachmentReferenceStencilLayout
• The sType value of each struct in the pNext chain must be unique
• layout must be a valid ImageLayout value

See Also

VK_KHR_create_renderpass2, VK_VERSION_1_2, FragmentShadingRateAttachmentInfoKHR, ImageAspectFlags, ImageLayout, StructureType, SubpassDescription2, SubpassDescriptionDepthStencilResolve

VkSubpassDescription2 - Structure specifying a subpass description

Description

Parameters defined by this structure with the same name as those in SubpassDescription have the identical effect to those parameters.

viewMask has the same effect for the described subpass as RenderPassMultiviewCreateInfo::pViewMasks has on each corresponding subpass.

If a FragmentShadingRateAttachmentInfoKHR structure is included in the pNext chain, pFragmentShadingRateAttachment is not NULL, and its attachment member is not ATTACHMENT_UNUSED, the identified attachment defines a fragment shading rate attachment for that subpass.

If any element of pResolveAttachments is an image specified with an ExternalFormatANDROID, values in the corresponding color attachment will be resolved to the resolve attachment in the same manner as specified for VkResolveModeFlagBits.html.

If the nullColorAttachmentWithExternalFormatResolve limit is TRUE, values in the color attachment will be loaded from the resolve attachment at the start of rendering, and may also be reloaded any time after a resolve occurs or the resolve attachment is written to; if this occurs it must happen-before any writes to the color attachment are performed which happen-after the resolve that triggers this. If any color component in the external format is subsampled, values will be read from the nearest sample in the image when they are loaded. If the color attachment is also used as an input attachment, the same behavior applies.

Setting the color attachment to ATTACHMENT_UNUSED when an external resolve attachment is used and the nullColorAttachmentWithExternalFormatResolve limit is TRUE will not result in color attachment writes to be discarded for that attachment.

When nullColorAttachmentWithExternalFormatResolve is TRUE, the color output from the subpass can still be read via an input attachment; but the application cannot bind an image view for the color attachment as there is no such image view bound. Instead to access the data as an input attachment applications can use the resolve attachment in its place - using the resolve attachment image for the descriptor, and setting the corresponding element of pInputAttachments to the index of the resolve attachment.

Loads or input attachment reads from the resolve attachment are performed as if using a SamplerYcbcrConversionCreateInfo with the following parameters:

VkSamplerYcbcrConversionCreateInfo createInfo = {
    .sType = VK_STRUCTURE_TYPE_SAMPLER_YCBCR_CONVERSION_CREATE_INFO,
    .pNext = NULL,
    .format = VK_FORMAT_UNDEFINED,
    .ycbcrModel = VK_SAMPLER_YCBCR_MODEL_CONVERSION_RGB_IDENTITY,
    .ycbcrRange = VK_SAMPLER_YCBCR_RANGE_ITU_FULL,
    .components = {
        .r = VK_COMPONENT_SWIZZLE_B
        .g = VK_COMPONENT_SWIZZLE_R
        .b = VK_COMPONENT_SWIZZLE_G
        .a = VK_COMPONENT_SWIZZLE_IDENTITY},
    .xChromaOffset = properties.chromaOffsetX,
    .yChromaOffset = properties.chromaOffsetY,
    .chromaFilter = ename:VK_FILTER_NEAREST,
    .forceExplicitReconstruction = ... };

where properties is equal to PhysicalDeviceExternalFormatResolvePropertiesANDROID returned by the device and forceExplicitReconstruction is effectively ignored as the SAMPLER_YCBCR_MODEL_CONVERSION_RGB_IDENTITY model is used. The applied swizzle is the same effective swizzle that would be applied by the SAMPLER_YCBCR_MODEL_CONVERSION_YCBCR_IDENTITY model, but no range expansion is applied.

Valid Usage

• If the attachment member of an element of pInputAttachments is not ATTACHMENT_UNUSED, its layout member must not be IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL or IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL

• If the attachment member of an element of pColorAttachments is not ATTACHMENT_UNUSED, its layout member must not be IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL or IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL
• If the attachment member of an element of pResolveAttachments is not ATTACHMENT_UNUSED, its layout member must not be IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL or IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL
• If the attachment member of pDepthStencilAttachment is not ATTACHMENT_UNUSED, ts layout member must not be IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL or IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL
• If the attachment member of an element of pColorAttachments is not ATTACHMENT_UNUSED, its layout member must not be IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL or IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL
• If the attachment member of an element of pResolveAttachments is not ATTACHMENT_UNUSED, its layout member must not be IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL or IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL
• If the attachment member of an element of pInputAttachments is not ATTACHMENT_UNUSED, its layout member must not be IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL or IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL
• If the attachment member of an element of pColorAttachments is not ATTACHMENT_UNUSED, its layout member must not be IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL, IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL, IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL, or IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL
• If the attachment member of an element of pResolveAttachments is not ATTACHMENT_UNUSED, its layout member must not be IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL, IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL, IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL, or IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL
• If the attachment member of an element of pInputAttachments is not ATTACHMENT_UNUSED, its layout member must not be IMAGE_LAYOUT_ATTACHMENT_OPTIMAL_KHR
• If the attachment member of an element of pColorAttachments is not ATTACHMENT_UNUSED, its layout member must not be IMAGE_LAYOUT_READ_ONLY_OPTIMAL_KHR
• If the attachment member of an element of pResolveAttachments is not ATTACHMENT_UNUSED, its layout member must not be IMAGE_LAYOUT_READ_ONLY_OPTIMAL_KHR
• If the attachment member of pDepthStencilAttachment is not ATTACHMENT_UNUSED and its pNext chain includes a AttachmentReferenceStencilLayout structure, the layout member of pDepthStencilAttachment must not be IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL or IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL
• pipelineBindPoint must be PIPELINE_BIND_POINT_GRAPHICS or PIPELINE_BIND_POINT_SUBPASS_SHADING_HUAWEI
• colorAttachmentCount must be less than or equal to PhysicalDeviceLimits::maxColorAttachments
• If the first use of an attachment in this render pass is as an input attachment, and the attachment is not also used as a color or depth/stencil attachment in the same subpass, then loadOp must not be ATTACHMENT_LOAD_OP_CLEAR
• If pResolveAttachments is not NULL, each resolve attachment that is not ATTACHMENT_UNUSED must have a sample count of SAMPLE_COUNT_1_BIT
• If externalFormatResolve is not enabled and pResolveAttachments is not NULL, for each resolve attachment that does not have the value ATTACHMENT_UNUSED, the corresponding color attachment must not have the value ATTACHMENT_UNUSED
• If the nullColorAttachmentWithExternalFormatResolve property is FALSE and pResolveAttachments is not NULL, for each resolve attachment that has a format of FORMAT_UNDEFINED, the corresponding color attachment must not have the value ATTACHMENT_UNUSED
• If the nullColorAttachmentWithExternalFormatResolve property is TRUE and pResolveAttachments is not NULL, for each resolve attachment that has a format of FORMAT_UNDEFINED, the corresponding color attachment must have the value ATTACHMENT_UNUSED
• If externalFormatResolve is not enabled and pResolveAttachments is not NULL, for each resolve attachment that is not ATTACHMENT_UNUSED, the corresponding color attachment must not have a sample count of SAMPLE_COUNT_1_BIT
• If externalFormatResolve is not enabled, each element of pResolveAttachments must have the same Format as its corresponding color attachment
• If none of the VK_AMD_mixed_attachment_samples extension, the VK_NV_framebuffer_mixed_samples extension, or the multisampledRenderToSingleSampled feature are enabled, all attachments in pColorAttachments that are not ATTACHMENT_UNUSED must have the same sample count

• All attachments in pInputAttachments that are not ATTACHMENT_UNUSED and any of the following is true:

  • the externalFormatResolve feature is not enabled
  • the nullColorAttachmentWithExternalFormatResolve property is FALSE
  • does not have a non-zero value of ExternalFormatANDROID::externalFormat

  must have image formats whose potential format features contain at least FORMAT_FEATURE_COLOR_ATTACHMENT_BIT or FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT

• All attachments in pColorAttachments that are not ATTACHMENT_UNUSED must have image formats whose potential format features contain FORMAT_FEATURE_COLOR_ATTACHMENT_BIT
• All attachments in pResolveAttachments that are not ATTACHMENT_UNUSED and do not have an image format of FORMAT_UNDEFINED must have image formats whose potential format features contain FORMAT_FEATURE_COLOR_ATTACHMENT_BIT
• If pDepthStencilAttachment is not NULL and the attachment is not ATTACHMENT_UNUSED then it must have an image format whose potential format features contain FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT
• If the linearColorAttachment feature is enabled and the image is created with IMAGE_TILING_LINEAR, all attachments in pInputAttachments that are not ATTACHMENT_UNUSED must have image formats whose potential format features must contain FORMAT_FEATURE_2_LINEAR_COLOR_ATTACHMENT_BIT_NV
• If the linearColorAttachment feature is enabled and the image is created with IMAGE_TILING_LINEAR, all attachments in pColorAttachments that are not ATTACHMENT_UNUSED must have image formats whose potential format features must contain FORMAT_FEATURE_2_LINEAR_COLOR_ATTACHMENT_BIT_NV
• If the linearColorAttachment feature is enabled and the image is created with IMAGE_TILING_LINEAR, all attachments in pResolveAttachments that are not ATTACHMENT_UNUSED must have image formats whose potential format features must contain FORMAT_FEATURE_2_LINEAR_COLOR_ATTACHMENT_BIT_NV
• If the VK_AMD_mixed_attachment_samples extension is enabled, all attachments in pColorAttachments that are not ATTACHMENT_UNUSED must have a sample count that is smaller than or equal to the sample count of pDepthStencilAttachment if it is not ATTACHMENT_UNUSED
• If the pNext chain includes a MultisampledRenderToSingleSampledInfoEXT structure with multisampledRenderToSingleSampledEnable equal to TRUE, then all attachments in pColorAttachments and pDepthStencilAttachment that are not ATTACHMENT_UNUSED must have a sample count that is either SAMPLE_COUNT_1_BIT or equal to MultisampledRenderToSingleSampledInfoEXT::rasterizationSamples
• If the pNext chain includes a MultisampledRenderToSingleSampledInfoEXT structure with multisampledRenderToSingleSampledEnable equal to TRUE, and pDepthStencilAttachment is not NULL, does not have the value ATTACHMENT_UNUSED, and has a sample count of SAMPLE_COUNT_1_BIT, the pNext chain must also include a SubpassDescriptionDepthStencilResolve structure with pDepthStencilResolveAttachment that is either NULL or has the value ATTACHMENT_UNUSED
• If none of the VK_AMD_mixed_attachment_samples extension, the VK_NV_framebuffer_mixed_samples extension, or the multisampledRenderToSingleSampled feature are enabled, all attachments in pDepthStencilAttachment or pColorAttachments that are not ATTACHMENT_UNUSED must have the same sample count
• Each element of pPreserveAttachments must not be ATTACHMENT_UNUSED
• Each element of pPreserveAttachments must not also be an element of any other member of the subpass description
• If any attachment is used by more than one AttachmentReference2 member, then each use must use the same layout
• If flags includes SUBPASS_DESCRIPTION_PER_VIEW_POSITION_X_ONLY_BIT_NVX, it must also include SUBPASS_DESCRIPTION_PER_VIEW_ATTRIBUTES_BIT_NVX
• If the attachment member of any element of pInputAttachments is not ATTACHMENT_UNUSED, then the aspectMask member must be a valid combination of ImageAspectFlagBits
• If the attachment member of any element of pInputAttachments is not ATTACHMENT_UNUSED, then the aspectMask member must not be 0
• If the attachment member of any element of pInputAttachments is not ATTACHMENT_UNUSED, then the aspectMask member must not include IMAGE_ASPECT_METADATA_BIT
• If the attachment member of any element of pInputAttachments is not ATTACHMENT_UNUSED, then the aspectMask member must not include VK_IMAGE_ASPECT_MEMORY_PLANE_i_BIT_EXT for any index i
• An attachment must not be used in both pDepthStencilAttachment and pColorAttachments
• If the multiview feature is not enabled, viewMask must be 0
• The index of the most significant bit in viewMask must be less than maxMultiviewViewCount
• If externalFormatResolve is enabled, pResolveAttachments is not NULL, and colorAttachmentCount is not 1, any element of pResolveAttachments that is not ATTACHMENT_UNUSED, must not have a format of FORMAT_UNDEFINED
• If externalFormatResolve is enabled, pResolveAttachments is not NULL, any element of pResolveAttachments is not ATTACHMENT_UNUSED and has a format of FORMAT_UNDEFINED, and the corresponding element of pColorAttachments is not ATTACHMENT_UNUSED, the color attachment must have a samples value of 1
• If externalFormatResolve is enabled, pResolveAttachments is not NULL, and any element of pResolveAttachments is not ATTACHMENT_UNUSED and has a format of FORMAT_UNDEFINED, viewMask must be 0
• If externalFormatResolve is enabled, pResolveAttachments is not NULL, and any element of pResolveAttachments is not ATTACHMENT_UNUSED and has a format of FORMAT_UNDEFINED, FragmentShadingRateAttachmentInfoKHR::pFragmentShadingRateAttachment must either be NULL or a AttachmentReference2 structure with a attachment value of ATTACHMENT_UNUSED
• If externalFormatResolve is enabled, pResolveAttachments is not NULL, and any element of pResolveAttachments is not ATTACHMENT_UNUSED and has a format of FORMAT_UNDEFINED, elements of pInputAttachments referencing either a color attachment or resolve attachment used in this subpass must not include VK_IMAGE_ASPECT_PLANE_i_BIT for any index i in its aspectMask

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_SUBPASS_DESCRIPTION_2

• Each pNext member of any structure (including this one) in the pNext chain must be either NULL or a pointer to a valid instance of FragmentShadingRateAttachmentInfoKHR, MultisampledRenderToSingleSampledInfoEXT, RenderPassCreationControlEXT, RenderPassSubpassFeedbackCreateInfoEXT, or SubpassDescriptionDepthStencilResolve
• The sType value of each struct in the pNext chain must be unique
• flags must be a valid combination of SubpassDescriptionFlagBits values
• pipelineBindPoint must be a valid PipelineBindPoint value
• If inputAttachmentCount is not 0, pInputAttachments must be a valid pointer to an array of inputAttachmentCount valid AttachmentReference2 structures
• If colorAttachmentCount is not 0, pColorAttachments must be a valid pointer to an array of colorAttachmentCount valid AttachmentReference2 structures
• If colorAttachmentCount is not 0, and pResolveAttachments is not NULL, pResolveAttachments must be a valid pointer to an array of colorAttachmentCount valid AttachmentReference2 structures
• If pDepthStencilAttachment is not NULL, pDepthStencilAttachment must be a valid pointer to a valid AttachmentReference2 structure
• If preserveAttachmentCount is not 0, pPreserveAttachments must be a valid pointer to an array of preserveAttachmentCount uint32_t values

See Also

VK_KHR_create_renderpass2, VK_VERSION_1_2, AttachmentReference2, PipelineBindPoint, RenderPassCreateInfo2, StructureType, SubpassDescriptionFlags

VkSubpassDependency2 - Structure specifying a subpass dependency

Description

Parameters defined by this structure with the same name as those in SubpassDependency have the identical effect to those parameters.

viewOffset has the same effect for the described subpass dependency as RenderPassMultiviewCreateInfo::pViewOffsets has on each corresponding subpass dependency.

If a MemoryBarrier2 is included in the pNext chain, srcStageMask, dstStageMask, srcAccessMask, and dstAccessMask parameters are ignored. The synchronization and access scopes instead are defined by the parameters of MemoryBarrier2.

Valid Usage

• If the geometryShader feature is not enabled, srcStageMask must not contain PIPELINE_STAGE_GEOMETRY_SHADER_BIT

• If the tessellationShader feature is not enabled, srcStageMask must not contain PIPELINE_STAGE_TESSELLATION_CONTROL_SHADER_BIT or PIPELINE_STAGE_TESSELLATION_EVALUATION_SHADER_BIT
• If the conditionalRendering feature is not enabled, srcStageMask must not contain PIPELINE_STAGE_CONDITIONAL_RENDERING_BIT_EXT
• If the fragmentDensityMap feature is not enabled, srcStageMask must not contain PIPELINE_STAGE_FRAGMENT_DENSITY_PROCESS_BIT_EXT
• If the transformFeedback feature is not enabled, srcStageMask must not contain PIPELINE_STAGE_TRANSFORM_FEEDBACK_BIT_EXT
• If the meshShader feature is not enabled, srcStageMask must not contain PIPELINE_STAGE_MESH_SHADER_BIT_EXT
• If the taskShader feature is not enabled, srcStageMask must not contain PIPELINE_STAGE_TASK_SHADER_BIT_EXT
• If neither the shadingRateImage or attachmentFragmentShadingRate are enabled, srcStageMask must not contain PIPELINE_STAGE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR
• If the synchronization2 feature is not enabled, srcStageMask must not be 0
• If neither the VK_NV_ray_tracing extension or rayTracingPipeline feature are enabled, srcStageMask must not contain PIPELINE_STAGE_RAY_TRACING_SHADER_BIT_KHR
• If the geometryShader feature is not enabled, dstStageMask must not contain PIPELINE_STAGE_GEOMETRY_SHADER_BIT
• If the tessellationShader feature is not enabled, dstStageMask must not contain PIPELINE_STAGE_TESSELLATION_CONTROL_SHADER_BIT or PIPELINE_STAGE_TESSELLATION_EVALUATION_SHADER_BIT
• If the conditionalRendering feature is not enabled, dstStageMask must not contain PIPELINE_STAGE_CONDITIONAL_RENDERING_BIT_EXT
• If the fragmentDensityMap feature is not enabled, dstStageMask must not contain PIPELINE_STAGE_FRAGMENT_DENSITY_PROCESS_BIT_EXT
• If the transformFeedback feature is not enabled, dstStageMask must not contain PIPELINE_STAGE_TRANSFORM_FEEDBACK_BIT_EXT
• If the meshShader feature is not enabled, dstStageMask must not contain PIPELINE_STAGE_MESH_SHADER_BIT_EXT
• If the taskShader feature is not enabled, dstStageMask must not contain PIPELINE_STAGE_TASK_SHADER_BIT_EXT
• If neither the shadingRateImage or attachmentFragmentShadingRate are enabled, dstStageMask must not contain PIPELINE_STAGE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR
• If the synchronization2 feature is not enabled, dstStageMask must not be 0
• If neither the VK_NV_ray_tracing extension or rayTracingPipeline feature are enabled, dstStageMask must not contain PIPELINE_STAGE_RAY_TRACING_SHADER_BIT_KHR
• srcSubpass must be less than or equal to dstSubpass, unless one of them is SUBPASS_EXTERNAL, to avoid cyclic dependencies and ensure a valid execution order
• srcSubpass and dstSubpass must not both be equal to SUBPASS_EXTERNAL
• If srcSubpass is equal to dstSubpass and srcStageMask includes a framebuffer-space stage, dstStageMask must only contain framebuffer-space stages
• Any access flag included in srcAccessMask must be supported by one of the pipeline stages in srcStageMask, as specified in the table of supported access types
• Any access flag included in dstAccessMask must be supported by one of the pipeline stages in dstStageMask, as specified in the table of supported access types
• If dependencyFlags includes DEPENDENCY_VIEW_LOCAL_BIT, srcSubpass must not be equal to SUBPASS_EXTERNAL
• If dependencyFlags includes DEPENDENCY_VIEW_LOCAL_BIT, dstSubpass must not be equal to SUBPASS_EXTERNAL
• If srcSubpass equals dstSubpass, and srcStageMask and dstStageMask both include a framebuffer-space stage, then dependencyFlags must include DEPENDENCY_BY_REGION_BIT
• If viewOffset is not equal to 0, srcSubpass must not be equal to dstSubpass
• If dependencyFlags does not include DEPENDENCY_VIEW_LOCAL_BIT, viewOffset must be 0

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_SUBPASS_DEPENDENCY_2

• pNext must be NULL or a pointer to a valid instance of MemoryBarrier2
• The sType value of each struct in the pNext chain must be unique
• srcStageMask must be a valid combination of PipelineStageFlagBits values
• dstStageMask must be a valid combination of PipelineStageFlagBits values
• srcAccessMask must be a valid combination of AccessFlagBits values
• dstAccessMask must be a valid combination of AccessFlagBits values
• dependencyFlags must be a valid combination of DependencyFlagBits values

See Also

VK_KHR_create_renderpass2, VK_VERSION_1_2, AccessFlags, DependencyFlags, PipelineStageFlags, RenderPassCreateInfo2, StructureType

VkRenderPassCreateInfo2 - Structure specifying parameters of a newly created render pass

Description

Parameters defined by this structure with the same name as those in RenderPassCreateInfo have the identical effect to those parameters; the child structures are variants of those used in RenderPassCreateInfo which add sType and pNext parameters, allowing them to be extended.

If the SubpassDescription2::viewMask member of any element of pSubpasses is not zero, multiview functionality is considered to be enabled for this render pass.

correlatedViewMaskCount and pCorrelatedViewMasks have the same effect as RenderPassMultiviewCreateInfo::correlationMaskCount and RenderPassMultiviewCreateInfo::pCorrelationMasks, respectively.

Valid Usage

• If any two subpasses operate on attachments with overlapping ranges of the same DeviceMemory object, and at least one subpass writes to that area of DeviceMemory, a subpass dependency must be included (either directly or via some intermediate subpasses) between them

• If the attachment member of any element of pInputAttachments, pColorAttachments, pResolveAttachments or pDepthStencilAttachment, or the attachment indexed by any element of pPreserveAttachments in any element of pSubpasses is bound to a range of a DeviceMemory object that overlaps with any other attachment in any subpass (including the same subpass), the AttachmentDescription2 structures describing them must include ATTACHMENT_DESCRIPTION_MAY_ALIAS_BIT in flags
• If the attachment member of any element of pInputAttachments, pColorAttachments, pResolveAttachments or pDepthStencilAttachment, or any element of pPreserveAttachments in any element of pSubpasses is not ATTACHMENT_UNUSED, then it must be less than attachmentCount
• If the pNext chain includes a RenderPassFragmentDensityMapCreateInfoEXT structure and the fragmentDensityMapAttachment member is not ATTACHMENT_UNUSED, then attachment must be less than attachmentCount
• If the pSubpasses pNext chain includes a SubpassDescriptionDepthStencilResolve structure and the pDepthStencilResolveAttachment member is not NULL and does not have the value ATTACHMENT_UNUSED, then attachment must be less than attachmentCount
• For any member of pAttachments with a loadOp equal to ATTACHMENT_LOAD_OP_CLEAR, the first use of that attachment must not specify a layout equal to IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL, IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL, or IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL
• For any member of pAttachments with a stencilLoadOp equal to ATTACHMENT_LOAD_OP_CLEAR, the first use of that attachment must not specify a layout equal to IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL, IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL, or IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL
• For any element of pDependencies, if the srcSubpass is not SUBPASS_EXTERNAL, all stage flags included in the srcStageMask member of that dependency must be a pipeline stage supported by the pipeline identified by the pipelineBindPoint member of the source subpass
• For any element of pDependencies, if the dstSubpass is not SUBPASS_EXTERNAL, all stage flags included in the dstStageMask member of that dependency must be a pipeline stage supported by the pipeline identified by the pipelineBindPoint member of the destination subpass
• The set of bits included in any element of pCorrelatedViewMasks must not overlap with the set of bits included in any other element of pCorrelatedViewMasks
• If the SubpassDescription2::viewMask member of all elements of pSubpasses is 0, correlatedViewMaskCount must be 0
• The SubpassDescription2::viewMask member of all elements of pSubpasses must either all be 0, or all not be 0
• If the SubpassDescription2::viewMask member of all elements of pSubpasses is 0, the dependencyFlags member of any element of pDependencies must not include DEPENDENCY_VIEW_LOCAL_BIT
• For any element of pDependencies where its srcSubpass member equals its dstSubpass member, if the viewMask member of the corresponding element of pSubpasses includes more than one bit, its dependencyFlags member must include DEPENDENCY_VIEW_LOCAL_BIT
• If the attachment member of any element of the pInputAttachments member of any element of pSubpasses is not ATTACHMENT_UNUSED, the aspectMask member of that element of pInputAttachments must only include aspects that are present in images of the format specified by the element of pAttachments specified by attachment
• The srcSubpass member of each element of pDependencies must be less than subpassCount
• The dstSubpass member of each element of pDependencies must be less than subpassCount
• If any element of pAttachments is used as a fragment shading rate attachment in any subpass, it must not be used as any other attachment in the render pass
• If any element of pAttachments is used as a fragment shading rate attachment, the loadOp for that attachment must not be ATTACHMENT_LOAD_OP_CLEAR
• If flags includes RENDER_PASS_CREATE_TRANSFORM_BIT_QCOM, an element of pSubpasses includes an instance of FragmentShadingRateAttachmentInfoKHR in its pNext chain, and the pFragmentShadingRateAttachment member of that structure is not equal to NULL, the attachment member of pFragmentShadingRateAttachment must be ATTACHMENT_UNUSED
• If any element of pAttachments is used as a fragment shading rate attachment in any subpass, it must have an image format whose potential format features contain FORMAT_FEATURE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR
• If the pipeline is being created with fragment shader state, and the VK_QCOM_render_pass_shader_resolve extension is enabled, and if subpass has any input attachments, and if the subpass description contains SUBPASS_DESCRIPTION_FRAGMENT_REGION_BIT_QCOM, then the sample count of the input attachments must equal rasterizationSamples
• If the pipeline is being created with fragment shader state, and the VK_QCOM_render_pass_shader_resolve extension is enabled, and if the subpass description contains SUBPASS_DESCRIPTION_FRAGMENT_REGION_BIT_QCOM, then sampleShadingEnable must be false
• If flags includes SUBPASS_DESCRIPTION_SHADER_RESOLVE_BIT_QCOM, and if pResolveAttachments is not NULL, then each resolve attachment must be ATTACHMENT_UNUSED
• If flags includes SUBPASS_DESCRIPTION_SHADER_RESOLVE_BIT_QCOM, and if pDepthStencilResolveAttachment is not NULL, then the depth/stencil resolve attachment must be ATTACHMENT_UNUSED
• If flags includes SUBPASS_DESCRIPTION_SHADER_RESOLVE_BIT_QCOM, then the subpass must be the last subpass in a subpass dependency chain
• If the attachment member of the pDepthStencilAttachment member of an element of pSubpasses is not ATTACHMENT_UNUSED, the layout member of that same structure is either IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL or IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL, and the pNext chain of that structure does not include a AttachmentReferenceStencilLayout structure, then the element of pAttachments with an index equal to attachment must not have a format that includes both depth and stencil components
• If the attachment member of the pDepthStencilAttachment member of an element of pSubpasses is not ATTACHMENT_UNUSED and the layout member of that same structure is either IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL or IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL, then the element of pAttachments with an index equal to attachment must have a format that includes only a stencil component
• If the attachment member of the pDepthStencilAttachment member of an element of pSubpasses is not ATTACHMENT_UNUSED and the layout member of that same structure is either IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL or IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL, then the element of pAttachments with an index equal to attachment must not have a format that includes only a stencil component
• If any element of pResolveAttachments of any element of pSubpasses references an attachment description with a format of FORMAT_UNDEFINED, RenderPassFragmentDensityMapCreateInfoEXT::fragmentDensityMapAttachment->attachment must be ATTACHMENT_UNUSED

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_RENDER_PASS_CREATE_INFO_2

• Each pNext member of any structure (including this one) in the pNext chain must be either NULL or a pointer to a valid instance of RenderPassCreationControlEXT, RenderPassCreationFeedbackCreateInfoEXT, or RenderPassFragmentDensityMapCreateInfoEXT
• The sType value of each struct in the pNext chain must be unique
• flags must be a valid combination of RenderPassCreateFlagBits values
• If attachmentCount is not 0, pAttachments must be a valid pointer to an array of attachmentCount valid AttachmentDescription2 structures
• pSubpasses must be a valid pointer to an array of subpassCount valid SubpassDescription2 structures
• If dependencyCount is not 0, pDependencies must be a valid pointer to an array of dependencyCount valid SubpassDependency2 structures
• If correlatedViewMaskCount is not 0, pCorrelatedViewMasks must be a valid pointer to an array of correlatedViewMaskCount uint32_t values
• subpassCount must be greater than 0

See Also

VK_KHR_create_renderpass2, VK_VERSION_1_2, AttachmentDescription2, RenderPassCreateFlags, StructureType, SubpassDependency2, SubpassDescription2, createRenderPass2, createRenderPass2KHR

VkSubpassBeginInfo - Structure specifying subpass begin information

Valid Usage

• If contents is SUBPASS_CONTENTS_INLINE_AND_SECONDARY_COMMAND_BUFFERS_EXT, then nestedCommandBuffer must be enabled

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_SUBPASS_BEGIN_INFO

• pNext must be NULL
• contents must be a valid SubpassContents value

See Also

VK_KHR_create_renderpass2, VK_VERSION_1_2, StructureType, SubpassContents, cmdBeginRenderPass2, cmdBeginRenderPass2KHR, cmdNextSubpass2, cmdNextSubpass2KHR