Function Prototype
vkCmdSetPerformanceMarkerINTEL
Markers
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);
pub fn cmd_set_performance_marker_intel(
command_buffer: vk::CommandBuffer,
p_marker_info: *const vk::PerformanceMarkerInfoINTEL,
) -> vk::Result;
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 VK_QUEUE_COMPUTE_BIT, VK_QUEUE_GRAPHICS_BIT, or VK_QUEUE_TRANSFER_BIT operations
VUID-vkCmdSetPerformanceMarkerINTEL-suspended
This command must not be called between suspended render pass instances
VUID-vkCmdSetPerformanceMarkerINTEL-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
Type
Function Prototype
Return Values
VK_SUCCESS
VK_ERROR_TOO_MANY_OBJECTS
VK_ERROR_OUT_OF_HOST_MEMORY
VK_ERROR_UNKNOWN
VK_ERROR_VALIDATION_FAILED
Command Buffer Level
primarysecondary
Queue Types
VK_QUEUE_GRAPHICS_BITVK_QUEUE_COMPUTE_BITVK_QUEUE_TRANSFER_BIT
Command Type
actionstate