VkGpaDeviceClockModeInfoAMD(3)

# VkGpaDeviceClockModeInfoAMD(3) Manual Page

## Name

VkGpaDeviceClockModeInfoAMD - Structure containing returned clock ratios or clock mode to set

## C Specification

The `VkGpaDeviceClockModeInfoAMD` structure is defined as:

    // Provided by VK_AMD_gpa_interface
    typedef struct VkGpaDeviceClockModeInfoAMD {
        VkStructureType            sType;
        const void*                pNext;
        VkGpaDeviceClockModeAMD    clockMode;
        float                      memoryClockRatioToPeak;
        float                      engineClockRatioToPeak;
    } VkGpaDeviceClockModeInfoAMD;

## Members

- `sType` is a VkStructureType value identifying this structure.

- `pNext` is `NULL` or a pointer to a structure extending this structure.

- `clockMode` is a enum:VkGpaDeviceClockModeAMD value specify which clock mode to set, or whether to query the current clocks.

- `memoryClockRatioToPeak` is the returned ratio of the current memory clock to the maximum memory clock, if `clockMode` is VK_GPA_DEVICE_CLOCK_MODE_QUERY_AMD.

- `engineClockRatioToPeak` is the returned ratio of the current engine clock to the maximum engine clock, if `clockMode` is VK_GPA_DEVICE_CLOCK_MODE_QUERY_AMD.

## Description

If `clockMode` is VK_GPA_DEVICE_CLOCK_MODE_QUERY_AMD, `memoryClockRatioToPeak` and `engineClockRatioToPeak` are filled with the ratios of their current values to their maximums respectively, otherwise they are left unchanged.

Valid Usage (Implicit)

- VUID-VkGpaDeviceClockModeInfoAMD-sType-sType
  `sType` must be VK_STRUCTURE_TYPE_GPA_DEVICE_CLOCK_MODE_INFO_AMD

- VUID-VkGpaDeviceClockModeInfoAMD-pNext-pNext
  `pNext` must be `NULL`

- VUID-VkGpaDeviceClockModeInfoAMD-clockMode-parameter
  `clockMode` must be a valid VkGpaDeviceClockModeAMD value

## See Also

VK_AMD_gpa_interface, VkGpaDeviceClockModeAMD, VkStructureType, vkSetGpaDeviceClockModeAMD

## 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