vkQueueSetPerfHintQCOM(3)

C Specification

To set a performance hint on a VkQueue object, call:

// Provided by VK_QCOM_queue_perf_hint
VkResult                   vkQueueSetPerfHintQCOM(
    VkQueue                                     queue,
    const VkPerfHintInfoQCOM*                   pPerfHintInfo);

Parameters

queue is the queue to set the performance hint on.
pPerfHintInfo is a pointer to a VkPerfHintInfoQCOM structure, describing the performance hint to set.

Description

Valid Usage

VUID-vkQueueSetPerfHintQCOM-queuePerfHint-12387
The queuePerfHint feature must be enabled
VUID-vkQueueSetPerfHintQCOM-queue-12388
queue must support at least one of the queue types specified in VkPhysicalDeviceQueuePerfHintPropertiesQCOM::supportedQueues

Valid Usage (Implicit)

VUID-vkQueueSetPerfHintQCOM-queue-parameter
queue must be a valid VkQueue handle
VUID-vkQueueSetPerfHintQCOM-pPerfHintInfo-parameter
pPerfHintInfo must be a valid pointer to a valid VkPerfHintInfoQCOM structure

Host Synchronization

Host access to queue must be externally synchronized if it was not created with VK_DEVICE_QUEUE_CREATE_INTERNALLY_SYNCHRONIZED_BIT_KHR

Command Properties

Command Buffer Levels

Render Pass Scope

Video Coding Scope

Supported Queue Types

-

-

-

Any

-

Return Codes

On success, this command returns

VK_SUCCESS

On failure, this command returns

See Also

VK_QCOM_queue_perf_hint, VkPerfHintInfoQCOM, VkQueue

Document Notes

For more information, see the Vulkan Specification.

This page is extracted from the Vulkan Specification. Fixes and changes should be made to the Specification, not directly.

Copyright

Copyright 2014-2026 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0