estrutura PEP_NOTIFY_COMPONENT_IDLE_STATE (pepfx.h)

Artigo
02/26/2024

A estrutura PEP_NOTIFY_COMPONENT_IDLE_STATE contém status informações sobre a transição pendente de um componente para um novo estado de energia Fx.

Sintaxe

typedef struct _PEP_NOTIFY_COMPONENT_IDLE_STATE {
  [in]  PEPHANDLE DeviceHandle;
  [in]  ULONG     Component;
  [in]  ULONG     IdleState;
  [in]  BOOLEAN   DriverNotified;
  [out] BOOLEAN   Completed;
} PEP_NOTIFY_COMPONENT_IDLE_STATE, *PPEP_NOTIFY_COMPONENT_IDLE_STATE;

Membros

[in] DeviceHandle

Um valor PEPHANDLE que identifica o dispositivo. O PEP forneceu esse identificador em resposta a uma notificação de PEP_DPM_REGISTER_DEVICE anterior.

[in] Component

O índice que identifica o componente. Esse membro é um índice na matriz Components na estrutura PEP_DEVICE_REGISTER_V2 que o PEP forneceu anteriormente em resposta à notificação de PEP_DPM_REGISTER_DEVICE para este dispositivo. Se a matriz Components contiver N elementos, os índices de componentes variam de 0 a N–1.

[in] IdleState

O novo estado de energia Fx para o qual o componente fará a transição. Se esse parâmetro for zero, o novo estado será F0; se esse parâmetro for um, o novo estado será F1; e assim por diante.

[in] DriverNotified

Se o driver do dispositivo já foi notificado sobre a transição pendente para o novo estado Fx . Se TRUE, a PoFx (estrutura de gerenciamento de energia ) já notificou o driver chamando a rotina de retorno de chamada ComponentIdleStateCallback do driver. Se FALSE, PoFx ainda não notificou o driver.

[out] Completed

Se o PEP concluiu todas as preparações necessárias para que o componente especificado entre no novo estado Fx . Defina como TRUE para indicar que o PEP concluiu todas as preparações necessárias ou como FALSE para indicar que não foi.

Se FALSE, o PEP deverá concluir os preparativos necessários posteriormente e informar pofx quando os preparativos tiverem sido concluídos. Para fazer isso, o PEP chama a rotina RequestWorker para solicitar um item de trabalho e responde à notificação de PEP_DPM_WORK que se seguiu enviando uma solicitação de trabalho do tipo PepWorkCompleteIdleState para informar à PoFx que as preparações estão concluídas.

Comentários

Essa estrutura é usada pela notificação PEP_DPM_NOTIFY_COMPONENT_IDLE_STATE . Os quatro primeiros membros dessa estrutura contêm valores de entrada fornecidos pelo PoFx. O membro Completed contém um valor de saída que o PEP grava na estrutura em resposta a essa notificação.