GetPwrCapabilities-Funktion (powerbase.h)

Ruft Informationen zu den Systemleistungsfunktionen ab.

Syntax

BOOLEAN GetPwrCapabilities(
  [out] PSYSTEM_POWER_CAPABILITIES lpspc
);

Parameter

[out] lpspc

Ein Zeiger auf eine SYSTEM_POWER_CAPABILITIES Struktur, die die Informationen 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

Diese Funktion ruft detaillierte Informationen zu den aktuellen Hardwareressourcen und Funktionen der Systemenergieverwaltung ab. Dies umfasst Informationen über das Vorhandensein von Hardwarefeatures wie Netztasten, Deckelschaltern und Batterien. Weitere zurückgegebene Details umfassen Informationen zu aktuellen Energieverwaltungsfunktionen und -konfigurationen, die sich dynamisch ändern können, z. B. der derzeit unterstützte minimale Ruhezustand, der sich ändern kann, wenn neue Treiber in das System eingeführt werden, oder das Vorhandensein der Systemwiederherstellungsdatei.

Diese Informationen sind auch über die CallNtPowerInformation-Funktion unter Verwendung der SystemPowerCapabilities-Ebene verfügbar.

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	powerbase.h
Bibliothek	PowrProf.lib
DLL	PowrProf.dll

Weitere Informationen

CallNtPowerInformation

Energieverwaltungsfunktionen

SYSTEM_POWER_CAPABILITIES