Function Prototype

vkCmdBeginConditionalRenderingEXT

Define the beginning of a conditional rendering block

Command Buffer Levelprimary / secondary

Render Pass Scopeboth

Queue Typesgraphics / compute

Tasksaction / state

To begin conditional rendering, call:

void vkCmdBeginConditionalRenderingEXT(
    VkCommandBuffer commandBuffer,
    const VkConditionalRenderingBeginInfoEXT* pConditionalRenderingBegin);

commandBuffer is the command buffer into which this command will be recorded.
pConditionalRenderingBegin is a pointer to a VkConditionalRenderingBeginInfoEXT structure specifying parameters of conditional rendering.

Valid Usage

VUID-vkCmdBeginConditionalRenderingEXT-None-01980

Conditional rendering must not already be active

Valid Usage (Implicit)

VUID-vkCmdBeginConditionalRenderingEXT-commandBuffer-parameter

commandBuffer must be a valid VkCommandBuffer handle

VUID-vkCmdBeginConditionalRenderingEXT-pConditionalRenderingBegin-parameter

pConditionalRenderingBegin must be a valid pointer to a valid VkConditionalRenderingBeginInfoEXT structure

VUID-vkCmdBeginConditionalRenderingEXT-commandBuffer-recording

commandBuffer must be in the recording state

VUID-vkCmdBeginConditionalRenderingEXT-commandBuffer-cmdpool

The VkCommandPool that commandBuffer was allocated from must support graphics, or compute operations

VUID-vkCmdBeginConditionalRenderingEXT-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 ::