POWER_REQUEST_TYPE-Enumeration (wdm.h)

Artikel
08/08/2023

Die POWER_REQUEST_TYPE-Enumeration gibt den Energieanforderungstyp an.

Syntax

typedef enum _POWER_REQUEST_TYPE {
  PowerRequestDisplayRequired,
  PowerRequestSystemRequired,
  PowerRequestAwayModeRequired,
  PowerRequestExecutionRequired
} POWER_REQUEST_TYPE, *PPOWER_REQUEST_TYPE;

Konstanten


`PowerRequestDisplayRequired` Nicht von Treibern verwendet. Weitere Informationen finden Sie in den Hinweisen.
`PowerRequestSystemRequired` Verhindert, dass der Computer nach einer Zeit der Benutzerinaktivität automatisch in den Ruhemodus wechselt.
`PowerRequestAwayModeRequired` Nicht von Treibern verwendet. Weitere Informationen finden Sie in den Hinweisen.
`PowerRequestExecutionRequired` Nicht von Treibern verwendet. Weitere Informationen finden Sie in den Hinweisen.

Hinweise

Diese Enumeration wird von den Kernelmodusroutinen PoClearPowerRequest und PoSetPowerRequest verwendet. Treiber, die diese Routinen aufrufen, müssen den PowerRequestSystemRequired-Enumerationswert angeben.

Die anderen drei Enumerationswerte – PowerRequestDisplayRequired, PowerRequestAwayModeRequired und PowerRequestExecutionRequired – werden nicht von Treibern verwendet. Anwendungen geben diese Energieanforderungstypen in Aufrufen der Funktionen PowerSetRequest und PowerClearRequest an.

Eine PowerRequestDisplayRequired-Energieanforderung hat die folgenden Auswirkungen:

Nach einer Zeit der Benutzerinaktivität bleibt die Sitzungsanzeige eingeschaltet und wird nicht automatisch deaktiviert.
Ein Bildschirmschoner wird nach einer Zeit der Benutzerinaktivität nicht automatisch gestartet.
Die Sitzung wird nach einer Zeit der Benutzerinaktivität nicht automatisch gesperrt. Wenn die Sitzung bereits gesperrt ist, wenn der Treiber die Energieanforderung sendet, bleibt die Sitzung gesperrt.

Ein PowerRequestSystemRequired muss zusätzlich zu einem PowerRequestDisplayRequired verwendet werden, um sicherzustellen, dass die Anzeige eingeschaltet bleibt und das System für die Dauer der Anforderung nicht in den Ruhezustand wechselt.

Wenn der Benutzer versucht, den Computer in den Standbymodus zu versetzen (z. B. durch Klicken auf Start und dann auf Ruhemodus), schaltet der Power-Manager Audio und Video aus, sodass sich der Computer im Standbymodus zu befinden scheint, aber der Computer weiterhin ausgeführt wird. Dies gilt nur für S3-Systeme (Traditional Sleep).

Während eine PowerRequestExecutionRequired-Energieanforderung wirksam ist, wird der aufrufende Prozess weiterhin ausgeführt, anstatt durch PLM-Mechanismen (Process Lifetime Management) angehalten oder beendet zu werden. Wann und wie lange der Prozess ausgeführt werden darf, hängt von den Einstellungen des Betriebssystems und der Energierichtlinie ab. Diese Art von Energieanforderung wird ab Windows 8 unterstützt.

Bei modernen Standby-Systemen mit Gleichstrom werden Die Stromanforderungen nach 5 Minuten beendet.

Mit Ausnahme von PowerRequestAwayModeRequired auf herkömmlichen Ruhemodussystemen (S3) werden Energieanforderungen beim benutzerinitiierten Systemmoduseintrag beendet (Ein-/Ausschalttaste, Deckel schließen oder Im Startmenü Ruhemodus auswählen).

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Wird ab Windows 7 unterstützt.
Kopfzeile	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Ntpoapi.h)

Weitere Informationen