Expand description
The GPU performance state APIs are used to get and set various performance levels on a per-GPU basis. P-States are GPU active/executing performance capability and power consumption states.
P-States range from P0 to P15, with P0 being the highest performance/power state, and P15 being the lowest performance/power state. Each P-State maps to a performance level. Not all P-States are available on a given system. The definition of each P-States are currently as follows:
P0/P1Maximum 3D performanceP2/P3Balanced 3D performance-powerP8Basic HD video playbackP10DVD playbackP12Minimum idle power consumption
Modules§
- private
- Undocumented API
Structs§
- NV_
GPU_ DYNAMIC_ PSTATES_ INFO_ EX - Used in NvAPI_GPU_GetDynamicPstatesInfoEx().
- NV_
GPU_ DYNAMIC_ PSTATES_ INFO_ EX_ UTILIZATION - NV_
GPU_ PERF_ PSTAT E20_ BASE_ VOLTAGE_ ENTRY_ V1 - NV_
GPU_ PERF_ PSTATE S20_ INFO_ V1 - Used in NvAPI_GPU_GetPstates20() interface call.
- NV_
GPU_ PERF_ PSTATE S20_ INFO_ V2 - Used in NvAPI_GPU_GetPstates20() interface call.
- NV_
GPU_ PERF_ PSTATE S20_ PARAM_ DELTA - Used to describe both voltage and frequency deltas
- NV_
GPU_ PERF_ PSTATE S20_ PSTATE - Performance state (P-State) settings
- NV_
GPU_ PSTAT E20_ CLOCK_ ENTRY_ DATA - NV_
GPU_ PSTAT E20_ CLOCK_ ENTRY_ RANGE - NV_
GPU_ PSTAT E20_ CLOCK_ ENTRY_ SINGLE - NV_
GPU_ PSTAT E20_ CLOCK_ ENTRY_ V1 - Used to describe single clock entry
Enums§
- NV_
GPU_ PSTAT E20_ CLOCK_ ENTRY_ DATA_ VALUE - Pstate
Clock Type - Used to identify clock type
- Pstate
Id - Utilization
Domain - Domain index into NV_GPU_DYNAMIC_PSTATES_INFO_EX.utilization.
- Voltage
Info Domain
Constants§
- NVAPI_
GPU_ PERF_ PSTAT E20_ CLOCK_ TYPE_ RANGE - Clock domains that allow range of frequency values within given pstate
- NVAPI_
GPU_ PERF_ PSTAT E20_ CLOCK_ TYPE_ SINGLE - Clock domains that use single frequency value within given pstate
- NVAPI_
GPU_ PERF_ PSTATE_ ALL - NVAPI_
GPU_ PERF_ PSTATE_ P0 - NVAPI_
GPU_ PERF_ PSTATE_ P1 - NVAPI_
GPU_ PERF_ PSTATE_ P2 - NVAPI_
GPU_ PERF_ PSTATE_ P3 - NVAPI_
GPU_ PERF_ PSTATE_ P4 - NVAPI_
GPU_ PERF_ PSTATE_ P5 - NVAPI_
GPU_ PERF_ PSTATE_ P6 - NVAPI_
GPU_ PERF_ PSTATE_ P7 - NVAPI_
GPU_ PERF_ PSTATE_ P8 - NVAPI_
GPU_ PERF_ PSTATE_ P9 - NVAPI_
GPU_ PERF_ PSTATE_ P10 - NVAPI_
GPU_ PERF_ PSTATE_ P11 - NVAPI_
GPU_ PERF_ PSTATE_ P12 - NVAPI_
GPU_ PERF_ PSTATE_ P13 - NVAPI_
GPU_ PERF_ PSTATE_ P14 - NVAPI_
GPU_ PERF_ PSTATE_ P15 - NVAPI_
GPU_ PERF_ PSTATE_ UNDEFINED - NVAPI_
GPU_ PERF_ VOLTAGE_ INFO_ DOMAIN_ CORE - NVAPI_
GPU_ PERF_ VOLTAGE_ INFO_ DOMAIN_ UNDEFINED - NVAPI_
GPU_ UTILIZATION_ DOMAIN_ BUS - NVAPI_
GPU_ UTILIZATION_ DOMAIN_ FB - NVAPI_
GPU_ UTILIZATION_ DOMAIN_ GPU - NVAPI_
GPU_ UTILIZATION_ DOMAIN_ VID - NVAPI_
MAX_ GPU_ PSTAT E20_ BASE_ VOLTAGES - NVAPI_
MAX_ GPU_ PSTAT E20_ CLOCKS - NVAPI_
MAX_ GPU_ PSTAT E20_ PSTATES - NVAPI_
MAX_ GPU_ UTILIZATIONS - NV_
GPU_ DYNAMIC_ PSTATES_ INFO_ EX_ VER - NV_
GPU_ PERF_ PSTATE S20_ INFO_ VER - NV_
GPU_ PERF_ PSTATE S20_ INFO_ VER1 - NV_
GPU_ PERF_ PSTATE S20_ INFO_ VER2 - NV_
GPU_ PERF_ PSTATE S20_ INFO_ VER3
Functions§
- NvAPI_
GPU_ ⚠GetCurrent Pstate - This function retrieves the current performance state (P-State).
- NvAPI_
GPU_ ⚠GetDynamic Pstates Info Ex - This API retrieves the NV_GPU_DYNAMIC_PSTATES_INFO_EX structure for the specified physical GPU.
- NvAPI_
GPU_ ⚠GetPstates20 - This API retrieves all performance states (P-States) 2.0 information.
Type Aliases§
- GPU_
GetCurrent Pstate Fn - GPU_
GetDynamic Pstates Info ExFn - GPU_
GetPstates20 Fn - NV_
GPU_ PERF_ PSTAT E20_ CLOCK_ TYPE_ ID - Used to identify clock type
- NV_
GPU_ PERF_ PSTATE S20_ INFO - NV_
GPU_ PERF_ PSTATE_ ID - NV_
GPU_ PERF_ VOLTAGE_ INFO_ DOMAIN_ ID - NV_
GPU_ UTILIZATION_ DOMAIN_ ID - Domain index into NV_GPU_DYNAMIC_PSTATES_INFO_EX.utilization.