VK_QCOM_queue_perf_hint(3)

# VK_QCOM_queue_perf_hint(3) Manual Page

## Name

VK_QCOM_queue_perf_hint - device extension

## Registered Extension Number

303

## Revision

1

## Ratification Status

Not ratified

## Extension and Version Dependencies

VK_KHR_get_physical_device_properties2
or
Vulkan Version 1.1

## Contact

- Matthew Netsch [GitHub]mnetsch

## Extension Proposal

VK_QCOM_queue_perf_hint

## Other Extension Metadata

Last Modified Date

  2026-02-26

IP Status

  No known IP claims.

Interactions and External Dependencies

  - Interacts with `VK_KHR_internally_synchronized_queues`

Contributors

  - Matthew Netsch, Qualcomm Technologies, Inc

## Description

This extension exposes power constraints to the application, allowing it to provide hints for influencing the device’s clock frequency.

These hints are `VkQueue` state and are persistent across the life of the queue until the app updates or removes the constraint. The kernel combines the constraints across the active queues from all processes to determine the actual clock frequency levels.

## New Commands

- vkQueueSetPerfHintQCOM

## New Structures

- VkPerfHintInfoQCOM

- Extending VkPhysicalDeviceFeatures2, VkDeviceCreateInfo:

  - VkPhysicalDeviceQueuePerfHintFeaturesQCOM

- Extending VkPhysicalDeviceProperties2:

  - VkPhysicalDeviceQueuePerfHintPropertiesQCOM

## New Enums

- VkPerfHintTypeQCOM

## New Enum Constants

- `VK_QCOM_QUEUE_PERF_HINT_EXTENSION_NAME`

- `VK_QCOM_QUEUE_PERF_HINT_SPEC_VERSION`

- Extending VkStructureType:

  - VK_STRUCTURE_TYPE_PERF_HINT_INFO_QCOM

  - VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_QUEUE_PERF_HINT_FEATURES_QCOM

  - VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_QUEUE_PERF_HINT_PROPERTIES_QCOM

## Issues

None.

## Version History

- Revision 1, 2026-02-26 (Matthew Netsch)

## See Also

No cross-references are available

## Document Notes

For more information, see the Vulkan Specification.

This page is a generated document. Fixes and changes should be made to the generator scripts, not directly.

## Copyright

Copyright 2014-2026 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0