ReadProcessorPwrScheme-Funktion (powrprof.h)
[ReadProcessorPwrScheme 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.]
Ruft die Energierichtlinieneinstellungen des Prozessors für das angegebene Energieschema ab.
Syntax
BOOLEAN ReadProcessorPwrScheme(
[in] UINT uiID,
[out] PMACHINE_PROCESSOR_POWER_POLICY pMachineProcessorPowerPolicy
);
Parameter
[in] uiID
Der Index des zu lesenden Energieschemas.
[out] pMachineProcessorPowerPolicy
Ein Zeiger auf eine MACHINE_PROCESSOR_POWER_POLICY-Struktur , die die Energierichtlinieneinstellungen des Prozessors empfängt.
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
Die MACHINE_PROCESSOR_POWER_POLICY-Struktur enthält Richtlinieneinstellungen für die Prozessorleistung, die verwendet werden können, während das System mit Netz- oder Akkubetrieb ausgeführt wird.
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 |