WriteProcessorPwrScheme-Funktion (powrprof.h)

[WriteProcessorPwrScheme ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Siehe Hinweise.]

Schreibt Prozessorenergierichtlinieneinstellungen für das angegebene Energieschema.

Syntax

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

Parameter

[in] uiID

Der Index des zu schreibenden Energieschemas.

[in] pMachineProcessorPowerPolicy

Ein Zeiger auf eine MACHINE_PROCESSOR_POWER_POLICY-Struktur , die die zu schreibenden Energierichtlinieneinstellungen enthält.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Diese Änderung wirkt sich nicht auf die aktuelle Systemenergierichtlinie aus. Rufen Sie die SetActivePwrScheme-Funktion mithilfe des Index dieses Energieschemas auf, um diese Änderung auf die aktuelle Systemenergierichtlinie anzuwenden.

Ab Windows Vista wird die Energieverwaltungskonfiguration des Systemprozessors über die Untergruppe GUID_PROCESSOR_SETTINGS_SUBGROUP Energieeinstellungen gesteuert. Verwenden Sie die PowerEnumerate-Funktion , um einzelne Einstellungen aufzulisten.

Weitere Informationen zur Verwendung von PowrProf.h finden Sie unter Energieschemas.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	powrprof.h
Bibliothek	PowrProf.lib
DLL	PowrProf.dll

Weitere Informationen

MACHINE_PROCESSOR_POWER_POLICY

Energieverwaltungsfunktionen

Energieschemas

ReadProcessorPwrScheme