writeProcessorPwrScheme 函式 (powrprof.h)

[WriteProcessorPwrScheme 可用於需求一節中指定的操作系統。它在後續版本中可能會變更或無法使用。請參閱備註。]

寫入指定電源配置的處理器電源原則設定。

語法

BOOLEAN WriteProcessorPwrScheme(
  [in] UINT                            uiID,
  [in] PMACHINE_PROCESSOR_POWER_POLICY pMachineProcessorPowerPolicy
);

[in] uiID

要寫入之電源配置的索引。

[in] pMachineProcessorPowerPolicy

包含要寫入之電源原則設定的MACHINE_PROCESSOR_POWER_POLICY 結構的指標。

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

這項變更不會影響目前的系統電源原則。若要將此變更套用至目前的系統電源原則，請使用此電源配置的索引呼叫 SetActivePwrScheme 函式。

從 Windows Vista 開始，系統會透過GUID_PROCESSOR_SETTINGS_SUBGROUP電源設定子群組來控制系統處理器的電源管理設定。使用 PowerEnumerate 函式列舉個別設定。

如需使用 PowrProf.h 的詳細資訊，請參閱 Power Schemes。