vkCmdSetPerformanceStreamMarkerINTEL(3)

C Specification

When monitoring the behavior of an application within the dataset generated by the entire set of applications running on the system, it is useful to identify draw calls within a potentially huge amount of performance data. To do so, application can generate stream markers that will be used to trace back a particular draw call with a particular performance data item.

// Provided by VK_INTEL_performance_query
VkResult vkCmdSetPerformanceStreamMarkerINTEL(
    VkCommandBuffer                             commandBuffer,
    const VkPerformanceStreamMarkerInfoINTEL*   pMarkerInfo);

Parameters

commandBuffer is a VkCommandBuffer into which a stream marker is added.
pMarkerInfo is a pointer to a VkPerformanceStreamMarkerInfoINTEL structure describing the marker to insert.

Description

Valid Usage (Implicit)

VUID-vkCmdSetPerformanceStreamMarkerINTEL-commandBuffer-parameter
commandBuffer must be a valid VkCommandBuffer handle
VUID-vkCmdSetPerformanceStreamMarkerINTEL-pMarkerInfo-parameter
pMarkerInfo must be a valid pointer to a valid VkPerformanceStreamMarkerInfoINTEL structure
VUID-vkCmdSetPerformanceStreamMarkerINTEL-commandBuffer-recording
commandBuffer must be in the recording state
VUID-vkCmdSetPerformanceStreamMarkerINTEL-commandBuffer-cmdpool
The VkCommandPool that commandBuffer was allocated from must support graphics, compute, or transfer operations
VUID-vkCmdSetPerformanceStreamMarkerINTEL-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