PoRegisterSystemState-Funktion (wdm.h)

  • Artikel

Die PoRegisterSystemState-Routine registriert das System aufgrund bestimmter Aktivitäten als ausgelastet.

Syntax

PVOID PoRegisterSystemState(
  [in, out] PVOID           StateHandle,
  [in]      EXECUTION_STATE Flags
);

Parameter

[in, out] StateHandle

Ein Zeiger auf einen vom Aufrufer bereitgestellten Puffer für ein Registrierungsstatushandle. Die Größe des Puffers in Bytes ist sizeof(ULONG). Bei NULL handelt es sich um eine neue Registrierung. Wenn dieser Parameter nicht NULL ist, verweist dieser Parameter auf ein Handle, das von einem vorherigen Aufruf von PoRegisterSystemState zurückgegeben wurde.

[in] Flags

Gibt den Typ der Aktivität an, der durch ein bitweises ODER von mindestens einem der folgenden Werte angegeben wird:

ES_SYSTEM_REQUIRED

Das System befindet sich unabhängig von der scheinbaren Auslastung nicht im Leerlauf.

ES_DISPLAY_REQUIRED

Die Verwendung der Anzeige ist erforderlich.

ES_USER_PRESENT

Ein Benutzer ist vorhanden.

ES_CONTINUOUS

Die Einstellungen sind fortlaufend und sollten bis zur expliziten Änderung in Kraft bleiben.

Rückgabewert

PoRegisterSystemState gibt ein Handle zurück, das später zum Ändern oder Aufheben der Registrierung des Systemstatus "Ausgelastet" verwendet werden soll. Es gibt NULL zurück, wenn das Handle nicht zugeordnet werden konnte.

Hinweise

PoRegisterSystemState registriert den Status "Ausgelastet" des Systems, wie durch die Flags angegeben. Die Registrierung bleibt bestehen, bis der Aufrufer sie mit einem anderen Aufruf von PoRegisterSystemState explizit ändert oder sie mit einem Aufruf von PoUnregisterSystemState abbricht.

Der Flags-Parameter gibt den Typ der laufenden Aktivität an. Treiber können eine beliebige Kombination der Flags angeben.

Durch festlegen ES_CONTINUOUS wird der Status "Ausgelastet" beibehalten, bis ein Treiber ihn durch Aufrufen von PoRegisterSystemState oder PoUnregisterSystemState explizit ändert oder abbricht.

Ein Treiber kann den Status "Ausgelastet" des Systems festlegen, um anzufordern, dass der Power Manager den Systembetriebszustand vermeiden soll, während die Treiberaktivität auftritt. Beachten Sie jedoch, dass unter bestimmten Umständen (z. B. bei einem extrem niedrigen Akku) der Energie-Manager diese Anforderung möglicherweise außer Kraft setzt und das System trotzdem in den Ruhezustand versetzt.

Um den Systemstromzustand festzulegen, rufen Sie PoSetSystemState auf.

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 <=APC_LEVEL

Weitere Informationen

PoSetSystemState

PoUnregisterSystemState