Function Prototype

vkCmdDebugMarkerInsertEXT

Insert a marker label into a command buffer
primary / secondary
both
graphics / compute
action

A single marker label can be inserted into a command buffer by calling:

void vkCmdDebugMarkerInsertEXT(
    VkCommandBuffer commandBuffer,
    const VkDebugMarkerMarkerInfoEXT* pMarkerInfo);
  • commandBuffer is the command buffer into which the command is recorded.
  • pMarkerInfo is a pointer to a VkDebugMarkerMarkerInfoEXT structure specifying the parameters of the marker to insert.

Valid Usage (Implicit)

VUID-vkCmdDebugMarkerInsertEXT-pMarkerInfo-parameter

pMarkerInfo must be a valid pointer to a valid VkDebugMarkerMarkerInfoEXT structure

VUID-vkCmdDebugMarkerInsertEXT-commandBuffer-cmdpool

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

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