vkCmdBeginConditionalRendering2EXT(3)

C Specification

To begin conditional rendering, call:

// Provided by VK_KHR_device_address_commands with VK_EXT_conditional_rendering
void vkCmdBeginConditionalRendering2EXT(
    VkCommandBuffer                             commandBuffer,
    const VkConditionalRenderingBeginInfo2EXT*  pConditionalRenderingBegin);

Parameters

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.

Description

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