VkSubpassBeginInfo(3)

# VkSubpassBeginInfo(3) Manual Page

## Name

VkSubpassBeginInfo - Structure specifying subpass begin information

Loading… please wait.

## C Specification

The `VkSubpassBeginInfo` structure is defined as:

Warning | This functionality is deprecated by Vulkan Version 1.4. See Deprecated Functionality for more information.

    // Provided by VK_VERSION_1_2
    typedef struct VkSubpassBeginInfo {
        VkStructureType      sType;
        const void*          pNext;
        VkSubpassContents    contents;
    } VkSubpassBeginInfo;

or the equivalent

    // Provided by VK_KHR_create_renderpass2
    typedef VkSubpassBeginInfo VkSubpassBeginInfoKHR;

## Members

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

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

- `contents` is a VkSubpassContents value specifying how the commands in the next subpass will be provided.

## Description

Valid Usage

- VUID-VkSubpassBeginInfo-contents-09382
  If `contents` is `VK_SUBPASS_CONTENTS_INLINE_AND_SECONDARY_COMMAND_BUFFERS_KHR`, then at least one of the following features must be enabled:

  - `maintenance7`

  - `nestedCommandBuffer`

Valid Usage (Implicit)

- VUID-VkSubpassBeginInfo-sType-sType
  `sType` must be `VK_STRUCTURE_TYPE_SUBPASS_BEGIN_INFO`

- VUID-VkSubpassBeginInfo-pNext-pNext
  `pNext` must be `NULL`

- VUID-VkSubpassBeginInfo-contents-parameter
  `contents` must be a valid VkSubpassContents value

## See Also

VK_KHR_create_renderpass2, VK_VERSION_1_2, VkStructureType, VkSubpassContents, vkCmdBeginRenderPass2, vkCmdBeginRenderPass2KHR, vkCmdNextSubpass2, vkCmdNextSubpass2KHR

## 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-2025 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0