VulkanHub
Function Prototype

vkCmdSetPerformanceOverrideINTEL

Performance override settings
primary / secondary
both
graphics / compute / transfer
state

Some applications might want measure the effect of a set of commands with a different settings. It is possible to override a particular settings using :

VkResult vkCmdSetPerformanceOverrideINTEL(
    VkCommandBuffer commandBuffer,
    const VkPerformanceOverrideInfoINTEL* pOverrideInfo);
  • commandBuffer is the command buffer where the override takes place.
  • pOverrideInfo is a pointer to a VkPerformanceOverrideInfoINTEL structure selecting the parameter to override.

Valid Usage

VUID-vkCmdSetPerformanceOverrideINTEL-pOverrideInfo-02736

pOverrideInfo must not be used with a VkPerformanceOverrideTypeINTEL that is not reported available by vkGetPerformanceParameterINTEL

Valid Usage (Implicit)

VUID-vkCmdSetPerformanceOverrideINTEL-commandBuffer-parameter

commandBuffer must be a valid VkCommandBuffer handle

VUID-vkCmdSetPerformanceOverrideINTEL-pOverrideInfo-parameter

pOverrideInfo must be a valid pointer to a valid VkPerformanceOverrideInfoINTEL structure

VUID-vkCmdSetPerformanceOverrideINTEL-commandBuffer-recording

commandBuffer must be in the recording state

VUID-vkCmdSetPerformanceOverrideINTEL-commandBuffer-cmdpool

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

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