VulkanHub
Function Prototype

vkCmdDebugMarkerEndEXT

Close a command buffer marker region
primary / secondary
both
graphics / compute
action

A marker region can be closed by calling:

void vkCmdDebugMarkerEndEXT(
    VkCommandBuffer commandBuffer);
  • commandBuffer is the command buffer into which the command is recorded.

An application may open a marker region in one command buffer and close it in another, or otherwise split marker regions across multiple command buffers or multiple queue submissions. When viewed from the linear series of submissions to a single queue, the calls to vkCmdDebugMarkerBeginEXT and vkCmdDebugMarkerEndEXTmust be matched and balanced.

Valid Usage

VUID-vkCmdDebugMarkerEndEXT-commandBuffer-01239

There must be an outstanding vkCmdDebugMarkerBeginEXT command prior to the vkCmdDebugMarkerEndEXT on the queue that commandBuffer is submitted to

VUID-vkCmdDebugMarkerEndEXT-commandBuffer-01240

If commandBuffer is a secondary command buffer, there must be an outstanding vkCmdDebugMarkerBeginEXT command recorded to commandBuffer that has not previously been ended by a call to vkCmdDebugMarkerEndEXT

Valid Usage (Implicit)

VUID-vkCmdDebugMarkerEndEXT-commandBuffer-parameter

commandBuffer must be a valid VkCommandBuffer handle

VUID-vkCmdDebugMarkerEndEXT-commandBuffer-recording

commandBuffer must be in the recording state

VUID-vkCmdDebugMarkerEndEXT-commandBuffer-cmdpool

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

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