estrutura PEP_DEVICE_POWER_STATE (pep_x.h)

Artigo
02/07/2025

A estrutura PEP_DEVICE_POWER_STATE indica o status de uma transição para um novo estado Dx (energia do dispositivo).

Sintaxe

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;

Membros

[in] DeviceHandle

O valor PEPHANDLE que identifica este dispositivo. O PEP criou anteriormente esse identificador em resposta a uma notificação de PEP_DPM_REGISTER_DEVICE da poFx (estrutura de gerenciamento de energia) do Windows.

[in] PowerState

Um valor de enumeração DEVICE_POWER_STATE que especifica o novo estado de energia do dispositivo.

[in] Complete

Se a transição para o novo estado de energia do dispositivo acabou de ser iniciada ou se acabou de ser concluída. Se TRUE, a transição para o estado de energia do dispositivo de destino foi concluída. Se FALSE, o PPO (proprietário da política de energia) iniciou a transição chamando a rotina de poRequestPowerIrp, mas o gerenciador de energia do Windows ainda não emitiu o IRP dox (uma solicitação IRP_MN_SET_POWER do tipo DevicePowerState) para a pilha de driver do dispositivo.

[in] SystemTransition

Sempre definido como FALSE.

Observações

Essa estrutura é usada pela notificação PEP_DPM_DEVICE_POWER_STATE. Todos os quatro membros da estrutura contêm valores de entrada fornecidos pela PoFx. O PEP não grava nessa estrutura.