vkCmdSetPerformanceStreamMarkerINTEL
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.
VkResult vkCmdSetPerformanceStreamMarkerINTEL(
VkCommandBuffer commandBuffer,
const VkPerformanceStreamMarkerInfoINTEL* pMarkerInfo);
pub fn cmd_set_performance_stream_marker_intel(
command_buffer: vk::CommandBuffer,
p_marker_info: *const vk::PerformanceStreamMarkerInfoINTEL,
) -> vk::Result;
commandBufferis a VkCommandBuffer into which a stream marker is added.pMarkerInfois a pointer to a VkPerformanceStreamMarkerInfoINTEL structure describing the marker to insert.
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 VK_QUEUE_COMPUTE_BIT, VK_QUEUE_GRAPHICS_BIT, or VK_QUEUE_TRANSFER_BIT operations
VUID-vkCmdSetPerformanceStreamMarkerINTEL-suspended
This command must not be called between suspended render pass instances
VUID-vkCmdSetPerformanceStreamMarkerINTEL-videocoding
This command must only be called outside of a video coding scope
Host Synchronization
- Host access to
commandBuffermust be externally synchronized - Host access to the
VkCommandPoolthatcommandBufferwas allocated from must be externally synchronized