estrutura PEP_DEVICE_POWER_STATE (pep_x.h)

Artigo
02/26/2024

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 esse 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 DEVICE_POWER_STATE valor de enumeração 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 PoRequestPowerIrp , mas o gerenciador de energia do Windows ainda não emitiu o Dx IRP (uma solicitação IRP_MN_SET_POWER do tipo DevicePowerState) para a pilha de driver do dispositivo.

[in] SystemTransition

Sempre definido como FALSE.

Comentários

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