VulkanHub
Function Prototype

vkCmdSetPerformanceMarkerINTEL

Markers
primary / secondary
both
graphics / compute / transfer
action / state

To help associate query results with a particular point at which an application emitted commands, markers can be set into the command buffers with the call:

VkResult vkCmdSetPerformanceMarkerINTEL(
    VkCommandBuffer commandBuffer,
    const VkPerformanceMarkerInfoINTEL* pMarkerInfo);

The last marker set onto a command buffer before the end of a query will be part of the query result.

Valid Usage (Implicit)

VUID-vkCmdSetPerformanceMarkerINTEL-commandBuffer-parameter

commandBuffer must be a valid VkCommandBuffer handle

VUID-vkCmdSetPerformanceMarkerINTEL-pMarkerInfo-parameter

pMarkerInfo must be a valid pointer to a valid VkPerformanceMarkerInfoINTEL structure

VUID-vkCmdSetPerformanceMarkerINTEL-commandBuffer-recording

commandBuffer must be in the recording state

VUID-vkCmdSetPerformanceMarkerINTEL-commandBuffer-cmdpool

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

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