NVML API Reference Guide (PDF) - vR340 (older) - Last updated July 1, 2014 - Send Feedback

## 4.14. NvmlClocksThrottleReasons

### Defines

#define nvmlClocksThrottleReasonAll
#define nvmlClocksThrottleReasonApplicationsClocksSetting 0x0000000000000002LL
#define nvmlClocksThrottleReasonGpuIdle 0x0000000000000001LL
#define nvmlClocksThrottleReasonHwSlowdown 0x0000000000000008LL
#define nvmlClocksThrottleReasonNone 0x0000000000000000LL
#define nvmlClocksThrottleReasonSwPowerCap 0x0000000000000004LL
#define nvmlClocksThrottleReasonUnknown 0x8000000000000000LL
#define nvmlClocksThrottleReasonUserDefinedClocks

### Defines

#define nvmlClocksThrottleReasonAll

  Bit mask representing all supported clocks throttling reasons New reasons might be added to this list in the future

  ###### Value

  (nvmlClocksThrottleReasonNone \ | nvmlClocksThrottleReasonGpuIdle \ | nvmlClocksThrottleReasonApplicationsClocksSetting \ | nvmlClocksThrottleReasonSwPowerCap \ | nvmlClocksThrottleReasonHwSlowdown \ | nvmlClocksThrottleReasonUnknown \ )

#define nvmlClocksThrottleReasonApplicationsClocksSetting 0x0000000000000002LL

  GPU clocks are limited by current setting of applications clocks

  See also:

  nvmlDeviceSetApplicationsClocks

  nvmlDeviceGetApplicationsClock

#define nvmlClocksThrottleReasonGpuIdle 0x0000000000000001LL

  Nothing is running on the GPU and the clocks are dropping to Idle state

  Note:

  This limiter may be removed in a later release

#define nvmlClocksThrottleReasonHwSlowdown 0x0000000000000008LL

  HW Slowdown (reducing the core clocks by a factor of 2 or more) is engaged

  This is an indicator of:

  - temperature being too high

  - External Power Brake Assertion is triggered (e.g. by the system power supply)

  - Power draw is too high and Fast Trigger protection is reducing the clocks

  - May be also reported during PState or clock change

    - This behavior may be removed in a later release.

  See also:

  nvmlDeviceGetTemperature

  nvmlDeviceGetTemperatureThreshold

  nvmlDeviceGetPowerUsage

#define nvmlClocksThrottleReasonNone 0x0000000000000000LL

  Bit mask representing no clocks throttling

  Clocks are as high as possible.

#define nvmlClocksThrottleReasonSwPowerCap 0x0000000000000004LL

  SW Power Scaling algorithm is reducing the clocks below requested clocks

  See also:

  nvmlDeviceGetPowerUsage

  nvmlDeviceSetPowerManagementLimit

  nvmlDeviceGetPowerManagementLimit

#define nvmlClocksThrottleReasonUnknown 0x8000000000000000LL

  Some other unspecified factor is reducing the clocks

#define nvmlClocksThrottleReasonUserDefinedClocks

  ###### Deprecated

  Renamed to nvmlClocksThrottleReasonApplicationsClocksSetting as the name describes the situation more accurately.

  ###### Value

  nvmlClocksThrottleReasonApplicationsClocksSetting

NVML API Reference Guide (PDF) - vR340 (older) - Last updated July 1, 2014 - Send Feedback