struttura PEP_DEVICE_POWER_STATE (pep_x.h)

Articolo
02/07/2025

La struttura PEP_DEVICE_POWER_STATE indica lo stato di una transizione a un nuovo stato Dx (alimentazione del dispositivo).

Sintassi

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;

Membri

[in] DeviceHandle

Valore PEPHANDLE che identifica questo dispositivo. Il PEP ha creato in precedenza questo handle in risposta a una notifica di PEP_DPM_REGISTER_DEVICE dal framework di risparmio energia di Windows (PoFx).

[in] PowerState

Valore di enumerazione DEVICE_POWER_STATE che specifica il nuovo stato di alimentazione del dispositivo.

[in] Complete

Se la transizione al nuovo stato di alimentazione del dispositivo è stata appena avviata o è stata appena completata. Se TRUE, la transizione allo stato di alimentazione del dispositivo di destinazione è stata completata. Se FALSE, il proprietario dei criteri di alimentazione (PPO) ha avviato la transizione chiamando la routine di PoRequestPowerIrp, ma il gestore energia di Windows non ha ancora emesso il Dx IRP (una richiesta di IRP_MN_SET_POWER di tipo DevicePowerState) allo stack di driver del dispositivo.

[in] SystemTransition

Impostare sempre su FALSE.

Osservazioni

Questa struttura viene utilizzata dalla notifica di PEP_DPM_DEVICE_POWER_STATE. Tutti e quattro i membri della struttura contengono valori di input forniti da PoFx. Il PEP non scrive in questa struttura.