VkRenderPassCreationControlEXT(3)

# VkRenderPassCreationControlEXT(3) Manual Page

## Name

VkRenderPassCreationControlEXT - Control about the creation of render pass or subpass

## C Specification

A `VkRenderPassCreationControlEXT` structure can be included in the `pNext` chain of `VkRenderPassCreateInfo2` or `pNext` chain of VkSubpassDescription2. The `VkRenderPassCreationControlEXT` structure is defined as:

Warning | This functionality is superseded by Vulkan Version 1.4 and VK_KHR_dynamic_rendering_local_read. See Legacy Functionality for more information.

    // Provided by VK_EXT_subpass_merge_feedback
    typedef struct VkRenderPassCreationControlEXT {
        VkStructureType    sType;
        const void*        pNext;
        VkBool32           disallowMerging;
    } VkRenderPassCreationControlEXT;

## Members

- `sType` is a VkStructureType value identifying this structure.

- `pNext` is `NULL` or a pointer to a structure extending this structure.

- `disallowMerging` is a boolean value indicating whether subpass merging will be disabled.

## Description

If a `VkRenderPassCreationControlEXT` structure is included in the `pNext` chain of VkRenderPassCreateInfo2 and its value of `disallowMerging` is VK_TRUE, the implementation will disable subpass merging for the entire render pass. If a `VkRenderPassCreationControlEXT` structure is included in the `pNext` chain of VkSubpassDescription2 and its value of `disallowMerging` is VK_TRUE, the implementation will disable merging the described subpass with previous subpasses in the render pass.

Valid Usage (Implicit)

- VUID-VkRenderPassCreationControlEXT-sType-sType
  `sType` must be VK_STRUCTURE_TYPE_RENDER_PASS_CREATION_CONTROL_EXT

Structure Chaining

Extends the structures

  - VkRenderPassCreateInfo2

  - VkSubpassDescription2

## See Also

VK_EXT_subpass_merge_feedback, VkBool32, VkRenderPassCreateInfo2, VkStructureType, VkSubpassDescription2, vkCreateRenderPass2

## Document Notes

For more information, see the Vulkan Specification.

This page is extracted from the Vulkan Specification. Fixes and changes should be made to the Specification, not directly.

## Copyright

Copyright 2014-2026 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0