PEP_DEVICE_POWER_STATE-Struktur (pepfx.h)

Artikel
03/01/2024

Die PEP_DEVICE_POWER_STATE-Struktur gibt die status eines Übergangs in einen neuen Dx-Zustand (Geräteleistung) an.

Syntax

typedef struct _PEP_DEVICE_POWER_STATE {
  [in] PEPHANDLE          DeviceHandle;
  [in] DEVICE_POWER_STATE PowerState;
  [in] BOOLEAN            Complete;
  [in] BOOLEAN            SystemTransition;
} PEP_DEVICE_POWER_STATE, *PPEP_DEVICE_POWER_STATE;

Member

[in] DeviceHandle

Der PEPHANDLE-Wert, der dieses Gerät identifiziert. Das PEP hat dieses Handle zuvor als Reaktion auf eine PEP_DPM_REGISTER_DEVICE Benachrichtigung aus dem Windows Power Management Framework (PoFx) erstellt.

[in] PowerState

Ein DEVICE_POWER_STATE Enumerationswert, der den Energiezustand des neuen Geräts angibt.

[in] Complete

Gibt an, ob der Übergang zum neuen Gerätestromzustand gerade initiiert oder gerade abgeschlossen wurde. Bei TRUE ist der Übergang zum Energiezustand des Zielgeräts abgeschlossen. Bei FALSE hat der Besitzer der Energierichtlinie (Power Policy Owner, PPO) den Übergang durch Aufrufen der PoRequestPowerIrp-Routine initiiert, aber der Windows-Energie-Manager hat noch nicht die Dx IRP (eine IRP_MN_SET_POWER Anforderung vom Typ DevicePowerState) an den Treiberstapel des Geräts ausgegeben.

[in] SystemTransition

Immer auf FALSE festgelegt.

Hinweise

Diese Struktur wird von der PEP_DPM_DEVICE_POWER_STATE Benachrichtigung verwendet. Alle vier Member der -Struktur enthalten Eingabewerte, die von PoFx bereitgestellt werden. Der PEP schreibt nicht in diese Struktur.