Events
May 19, 6 PM - May 23, 12 AM
Calling all developers, creators, and AI innovators to join us in Seattle @Microsoft Build May 19-22.
Register todayReadProcessorPwrScheme function (powrprof.h)
[ReadProcessorPwrScheme is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions. See Remarks.]
Retrieves the processor power policy settings for the specified power scheme.
BOOLEAN ReadProcessorPwrScheme(
[in] UINT uiID,
[out] PMACHINE_PROCESSOR_POWER_POLICY pMachineProcessorPowerPolicy
);
[in] uiID
The index of the power scheme to be read.
[out] pMachineProcessorPowerPolicy
A pointer to a MACHINE_PROCESSOR_POWER_POLICY structure that receives the processor power policy settings.
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.
The MACHINE_PROCESSOR_POWER_POLICY structure contains processor power policy settings for use while the system is running on AC power or battery power.
Starting with Windows Vista, power management configuration of the system's processor is controlled through the GUID_PROCESSOR_SETTINGS_SUBGROUP power settings subgroup. Use the PowerEnumerate function to enumerate individual settings.
For more information on using PowrProf.h, see Power Schemes.
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | powrprof.h |
| Library | PowrProf.lib |
| DLL | PowrProf.dll |