VulkanHub
Function Prototype

vkCmdBeginConditionalRendering2EXT

Define the beginning of a conditional rendering block

To begin conditional rendering, call:

void vkCmdBeginConditionalRendering2EXT(
    VkCommandBuffer   commandBuffer,
    const VkConditionalRenderingBeginInfo2EXT* pConditionalRenderingBegin);
  • commandBuffer is the command buffer into which this command will be recorded.
  • pConditionalRenderingBegin is a pointer to a VkConditionalRenderingBeginInfo2EXT structure specifying parameters of conditional rendering.

Valid Usage

VUID-vkCmdBeginConditionalRendering2EXT-None-13063

Conditional rendering must not already be active

Valid Usage (Implicit)

VUID-vkCmdBeginConditionalRendering2EXT-commandBuffer-parameter

commandBuffer must be a valid VkCommandBuffer handle

VUID-vkCmdBeginConditionalRendering2EXT-pConditionalRenderingBegin-parameter

pConditionalRenderingBegin must be a valid pointer to a valid VkConditionalRenderingBeginInfo2EXT structure

VUID-vkCmdBeginConditionalRendering2EXT-commandBuffer-recording

commandBuffer must be in the recording state

VUID-vkCmdBeginConditionalRendering2EXT-commandBuffer-cmdpool

The VkCommandPool that commandBuffer was allocated from must support VK_QUEUE_COMPUTE_BIT, or VK_QUEUE_GRAPHICS_BIT operations

VUID-vkCmdBeginConditionalRendering2EXT-suspended

This command must not be called between suspended render pass instances

VUID-vkCmdBeginConditionalRendering2EXT-videocoding

This command must only be called outside of a video coding scope

Host Synchronization

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