vkCmdNextSubpass2(3)

Name

vkCmdNextSubpass2 - Transition to the next subpass of a render pass

C Specification

To transition to the next subpass in the render pass instance afterrecording the commands for a subpass, call:

This functionality is superseded byVulkan Version 1.4. SeeLegacy Functionality for more information.

// Provided by VK_VERSION_1_2void vkCmdNextSubpass2(    VkCommandBuffer                             commandBuffer,    const VkSubpassBeginInfo*                   pSubpassBeginInfo,    const VkSubpassEndInfo*                     pSubpassEndInfo);

// Provided by VK_KHR_create_renderpass2// Equivalent to vkCmdNextSubpass2void vkCmdNextSubpass2KHR(    VkCommandBuffer                             commandBuffer,    const VkSubpassBeginInfo*                   pSubpassBeginInfo,    const VkSubpassEndInfo*                     pSubpassEndInfo);

Parameters

commandBuffer is the command buffer in which to record thecommand.
pSubpassBeginInfo is a pointer to aVkSubpassBeginInfostructure containing information about the subpass which is about tobegin rendering.
pSubpassEndInfo is a pointer to aVkSubpassEndInfo structurecontaining information about how the previous subpass will be ended.

Description

vkCmdNextSubpass2 is semantically identical tovkCmdNextSubpass,except that it is extensible, and thatcontents is provided as part ofan extensible structure instead of as a flat parameter.

Valid Usage

VUID-vkCmdNextSubpass2-None-03102
The current subpass indexmust be less than the number of subpasses inthe render pass minus one
VUID-vkCmdNextSubpass2-None-02350
This commandmust not be recorded when transform feedback is active

Valid Usage (Implicit)

VUID-vkCmdNextSubpass2-commandBuffer-parameter
commandBuffermust be a validVkCommandBuffer handle
VUID-vkCmdNextSubpass2-pSubpassBeginInfo-parameter
pSubpassBeginInfomust be a valid pointer to a validVkSubpassBeginInfo structure
VUID-vkCmdNextSubpass2-pSubpassEndInfo-parameter
pSubpassEndInfomust be a valid pointer to a validVkSubpassEndInfo structure
VUID-vkCmdNextSubpass2-commandBuffer-recording
commandBuffermust be in therecording state
VUID-vkCmdNextSubpass2-commandBuffer-cmdpool
TheVkCommandPool thatcommandBuffer was allocated frommust supportVK_QUEUE_GRAPHICS_BIT operations
VUID-vkCmdNextSubpass2-renderpass
This commandmust only be called inside of a render pass instance
VUID-vkCmdNextSubpass2-suspended
This commandmust not be called between suspended render pass instances
VUID-vkCmdNextSubpass2-videocoding
This commandmust only be called outside of a video coding scope
VUID-vkCmdNextSubpass2-bufferlevel
commandBuffermust be a primaryVkCommandBuffer

Host Synchronization

Host access tocommandBuffermust be externally synchronized
Host access to theVkCommandPool thatcommandBuffer was allocated frommust be externally synchronized

Command Properties

Command Buffer Levels	Render Pass Scope	Video Coding Scope	Supported Queue Types	Command Type
Primary	Inside	Outside	VK_QUEUE_GRAPHICS_BIT	Action State Synchronization

Conditional Rendering

vkCmdNextSubpass2 is not affected byconditional rendering

Document Notes

For more information, see theVulkan Specification.

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

Movatterモバイル変換