estrutura PEP_NOTIFY_COMPONENT_IDLE_STATE (pep_x.h)

Artigo
02/07/2025

A estrutura PEP_NOTIFY_COMPONENT_IDLE_STATE contém informações de status sobre a transição pendente de um componente para um novo estado de energia do 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 componentes na estrutura de PEP_DEVICE_REGISTER_V2 fornecida anteriormente pelo PEP em resposta à notificação de PEP_DPM_REGISTER_DEVICE deste dispositivo. Se a matriz Componentes contiver N elementos, os índices de componentes variam de 0 a N–1.

[in] IdleState

O novo Fx estado de energia 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 dedo F x. Se VERDADEIRO, o da estrutura de gerenciamento de energia (PoFx) já notificou o driver chamando o componentIdleStateCallback do driver rotina de retorno de chamada. 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 insira o novo estado do Fx. Defina como TRUE para indicar que o PEP concluiu todas as preparações necessárias ou false para indicar que não foi.

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

Observações

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