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 |