Structure specifying command buffer inheritance info for dynamic render pass instances.

Description

If the pNext chain of VkCommandBufferInheritanceInfo includes a VkCommandBufferInheritanceRenderingInfo structure, then that structure controls parameters of dynamic render pass instances that the VkCommandBuffer can be executed within. If VkCommandBufferInheritanceInfo::renderPass is not NULL_HANDLE, or COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT is not specified in VkCommandBufferBeginInfo::flags, parameters of this structure are ignored.

If colorAttachmentCount is 0 and the variableMultisampleRate feature is enabled, rasterizationSamples is ignored.

If depthAttachmentFormat, stencilAttachmentFormat, or any element of pColorAttachmentFormats is FORMAT_UNDEFINED, it indicates that the corresponding attachment is unused within the render pass and writes to those attachments are discarded.

Valid Usage

• If colorAttachmentCount is not 0, rasterizationSamples must be a valid VkSampleCountFlagBits value
• If the variableMultisampleRate feature is not enabled, rasterizationSamples must be a valid VkSampleCountFlagBits value
• If depthAttachmentFormat is not FORMAT_UNDEFINED, it must be a format that includes a depth component
• If depthAttachmentFormat is not FORMAT_UNDEFINED, it must be a format with potential format features that include FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT
• If any element of pColorAttachmentFormats is not FORMAT_UNDEFINED, it must be a format with potential format features that include FORMAT_FEATURE_COLOR_ATTACHMENT_BIT , or FORMAT_FEATURE_2_LINEAR_COLOR_ATTACHMENT_BIT_NV if the linearColorAttachment feature is enabled
• If stencilAttachmentFormat is not FORMAT_UNDEFINED, it must be a format that includes a stencil aspect
• If stencilAttachmentFormat is not FORMAT_UNDEFINED, it must be a format with potential format features that include FORMAT_FEATURE_DEPTH_STENCIL_ATTACHMENT_BIT
• If depthAttachmentFormat is not FORMAT_UNDEFINED and stencilAttachmentFormat is not FORMAT_UNDEFINED, depthAttachmentFormat must equal stencilAttachmentFormat
• 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

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_COMMAND_BUFFER_INHERITANCE_RENDERING_INFO
• flags must be a valid combination of VkRenderingFlagBits values
• If colorAttachmentCount is not 0, pColorAttachmentFormats must be a valid pointer to an array of colorAttachmentCount valid VkFormat values
• depthAttachmentFormat must be a valid VkFormat value
• stencilAttachmentFormat must be a valid VkFormat value
• If rasterizationSamples is not 0, rasterizationSamples must be a valid VkSampleCountFlagBits value

Layout

struct VkCommandBufferInheritanceRenderingInfo {
    VkStructureType sType;
    void const * pNext;
    VkRenderingFlags flags;
    uint32_t viewMask;
    uint32_t colorAttachmentCount;
    VkFormat const * pColorAttachmentFormats;
    VkFormat depthAttachmentFormat;
    VkFormat stencilAttachmentFormat;
    VkSampleCountFlagBits rasterizationSamples;
}