POWER_REQUEST_TYPE-Enumeration (ntpoapi.h)

Artikel
08/07/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` Wird nicht von Treibern verwendet. Weitere Informationen finden Sie in den Hinweisen.
`PowerRequestSystemRequired` Verhindert, dass der Computer nach einer Phase der Benutzerinaktivität automatisch in den Standbymodus wechselt.
`PowerRequestAwayModeRequired` Wird nicht von Treibern verwendet. Weitere Informationen finden Sie in den Hinweisen.
`PowerRequestExecutionRequired` Wird nicht von Treibern verwendet. Weitere Informationen finden Sie in den Hinweisen.

Hinweise

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

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

Eine PowerRequestDisplayRequired-Energieanforderung hat die folgenden Auswirkungen:

Nach einer Phase der Benutzerinaktivität bleibt die Sitzungsanzeige aktiviert und wird nicht automatisch deaktiviert. Wenn die Anzeige bereits ausgeschaltet ist, schaltet die Energieanforderung die Anzeige ein.
Ein Bildschirmschoner wird nach einer Zeit der Benutzerinaktivität nicht automatisch gestartet. Wenn bereits ein Bildschirmschoner ausgeführt wird, beendet die Energieanforderung den Bildschirmschoner.
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.

Während eine PowerRequestAwayModeRequired-Energieanforderung aktiv ist, schaltet der Power Manager Audio und Video aus, wenn der Benutzer versucht, den Computer in den Standbymodus zu versetzen (z. B. durch Klicken auf Start und dann auf Standbymodus), der Power Manager deaktiviert Audio und Video, sodass sich der Computer im Standbymodus zu befinden scheint, aber der Computer weiterhin ausgeführt wird.

Während eine PowerRequestExecutionRequired-Energieanforderung aktiv ist, wird der aufrufende Prozess weiterhin ausgeführt, anstatt von 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.