PoSetSystemState-Funktion (wdm.h)
Treiber rufen die PoSetSystemState-Routine auf, um anzugeben, dass das System aktiv ist.
Syntax
void PoSetSystemState(
[in] EXECUTION_STATE Flags
);
Parameter
[in] Flags
Gibt die Systemaktivität an, die durch ein bitweises OR mit einem oder mehreren der folgenden Werte angegeben wird:
ES_SYSTEM_REQUIRED
Das System befindet sich unabhängig von der scheinbaren Last nicht im Leerlauf.
ES_DISPLAY_REQUIRED
Die Verwendung der Anzeige ist erforderlich.
ES_USER_PRESENT
Ein Benutzer ist vorhanden.
Rückgabewert
Keine
Bemerkungen
Ein Treiber ruft PoSetSystemState auf, um Flags festzulegen, die angeben, dass die Systemaktivität stattfindet. Im Gegensatz zu PoRegisterSystemState lässt diese Routine dem Treiber nicht zu, einen dauerhaften Ausgelastungszustand festzulegen.
Der Parameter Flags gibt den Typ der aktivität an, die ausgeführt wird. Treiber können eine beliebige Kombination der Flags angeben.
Treiber können den Status "Ausgelastet" des Systems festlegen, um anzufordern, dass das System den Arbeitszustand nicht verlässt, während die Treiberaktivität auftritt. Beachten Sie jedoch, dass der Energie-Manager unter bestimmten Umständen (z. B. bei einem extrem niedrigen Akku) diese Anforderung außer Kraft setzen und das System trotzdem in den Energiesparmodus versetzt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows 2000. |
| Zielplattform | Universell |
| Header | wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <=DISPATCH_LEVEL |