Function Prototype

vkCmdBeginGpaSessionAMD

Begin a GPA session

To begin a GPA session, call:

VkResult vkCmdBeginGpaSessionAMD(
    VkCommandBuffer commandBuffer,
    VkGpaSessionAMD                   gpaSession);

pub fn cmd_begin_gpa_session_amd(
    command_buffer: vk::CommandBuffer,
    gpa_session: vk::GpaSessionAMD,
) -> vk::Result;

commandBuffer is the command buffer into which the command will be recorded.
gpaSession is the handle of the GPA session to begin.

Valid Usage

VUID-vkCmdBeginGpaSessionAMD-gpaSession-12409

If gpaSession has been used previously to begin and end a session, vkResetGpaSessionAMD must have first been called

VUID-vkCmdBeginGpaSessionAMD-commandBuffer-12410

If another GPA session has been started with vkCmdBeginGpaSessionAMD in commandBuffer, it must have been ended using vkCmdEndGpaSessionAMD before this call

Valid Usage (Implicit)

VUID-vkCmdBeginGpaSessionAMD-commandBuffer-parameter

commandBuffer must be a valid VkCommandBuffer handle

VUID-vkCmdBeginGpaSessionAMD-gpaSession-parameter

gpaSession must be a valid VkGpaSessionAMD handle

VUID-vkCmdBeginGpaSessionAMD-commandBuffer-recording

commandBuffer must be in the recording state

VUID-vkCmdBeginGpaSessionAMD-commandBuffer-cmdpool

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

VUID-vkCmdBeginGpaSessionAMD-suspended

This command must not be called between suspended render pass instances

VUID-vkCmdBeginGpaSessionAMD-videocoding

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

VUID-vkCmdBeginGpaSessionAMD-commonparent

Both of commandBuffer, and gpaSession must have been created, allocated, or retrieved from the same VkDevice

Host Synchronization

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