Skip to content

Latest commit

 

History

History
98 lines (70 loc) · 3.3 KB

nf-powrprof-writeprocessorpwrscheme.md

File metadata and controls

98 lines (70 loc) · 3.3 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:powrprof.WriteProcessorPwrScheme
WriteProcessorPwrScheme function (powrprof.h)
Writes processor power policy settings for the specified power scheme.
WriteProcessorPwrScheme
WriteProcessorPwrScheme function
_win32_writeprocessorpwrscheme
base.writeprocessorpwrscheme
powrprof/WriteProcessorPwrScheme
base\writeprocessorpwrscheme.htm
base
70e18f50-4774-4a7c-8fe0-7fd6a54aaa90
12/05/2018
WriteProcessorPwrScheme, WriteProcessorPwrScheme function, _win32_writeprocessorpwrscheme, base.writeprocessorpwrscheme, powrprof/WriteProcessorPwrScheme
powrprof.h
Windows
Windows XP [desktop apps only]
Windows Server 2003 [desktop apps only]
PowrProf.lib
PowrProf.dll
Windows
19H1
WriteProcessorPwrScheme
powrprof/WriteProcessorPwrScheme
c++
APIRef
kbSyntax
DllExport
PowrProf.dll
WriteProcessorPwrScheme

WriteProcessorPwrScheme function

-description

[WriteProcessorPwrScheme is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions. See Remarks.]

Writes processor power policy settings for the specified power scheme.

-parameters

-param uiID [in]

The index of the power scheme to be written.

-param pMachineProcessorPowerPolicy [in]

A pointer to a MACHINE_PROCESSOR_POWER_POLICY structure that contains the power policy settings to be written.

-returns

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.

-remarks

This change does not affect the current system power policy. To apply this change to the current system power policy, call the SetActivePwrScheme function, using the index of this power scheme.

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.

-see-also

MACHINE_PROCESSOR_POWER_POLICY

Power Management Functions

Power Schemes

ReadProcessorPwrScheme