structure PEP_DEVICE_POWER_STATE (pep_x.h)

Article
02/07/2025

La structure PEP_DEVICE_POWER_STATE indique l’état d’une transition vers un nouvel état Dx (alimentation de l’appareil).

Syntaxe

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;

Membres

[in] DeviceHandle

Valeur PEPHANDLE qui identifie cet appareil. Le pep a créé précédemment ce handle en réponse à une notification de PEP_DPM_REGISTER_DEVICE du framework de gestion de l’alimentation Windows (PoFx).

[in] PowerState

Valeur d’énumération DEVICE_POWER_STATE qui spécifie le nouvel état d’alimentation de l’appareil.

[in] Complete

Indique si la transition vers le nouvel état d’alimentation de l’appareil vient d’être lancée ou vient de se terminer. Si la valeur est TRUE, la transition vers l’état d’alimentation de l’appareil cible est terminée. Si la valeur est FALSE, le propriétaire de la stratégie d’alimentation (PPO) a lancé la transition en appelant la routine PoRequestPowerIrp, mais windows power manager n’a pas encore émis l’IRP Dx (une requête IRP_MN_SET_POWER de type DevicePowerState) à la pile des pilotes de l’appareil.

[in] SystemTransition

Toujours défini sur FALSE.

Remarques

Cette structure est utilisée par la notification PEP_DPM_DEVICE_POWER_STATE. Les quatre membres de la structure contiennent des valeurs d’entrée fournies par PoFx. Le PEP n’écrit pas dans cette structure.