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

Weitere Informationen

PoRegisterSystemState

PoUnregisterSystemState