estrutura PO_FX_CORE_DEVICE (pepfx.h)

Artigo
08/07/2023

A estrutura PO_FX_CORE_DEVICE contém informações sobre os atributos de estado de energia dos componentes em um recurso de sistema principal e fornece uma interface de software para o gerenciamento de energia desses componentes.

Sintaxe

typedef struct _PO_FX_CORE_DEVICE {
  ULONG                                         Version;
  ULONG                                         ComponentCount;
  PPO_FX_COMPONENT_ACTIVE_CONDITION_CALLBACK    ComponentActiveConditionCallback;
  PPO_FX_COMPONENT_IDLE_CONDITION_CALLBACK      ComponentIdleConditionCallback;
  PPO_FX_COMPONENT_CRITICAL_TRANSITION_CALLBACK ComponentCriticalTransitionCallback;
  PPO_FX_COMPONENT_IDLE_STATE_CALLBACK          ComponentIdleStateCallback;
  PVOID                                         DeviceContext;
  PO_FX_COMPONENT                               Components[ANYSIZE_ARRAY];
} PO_FX_CORE_DEVICE, *PPO_FX_CORE_DEVICE;

Membros

Version

O número de versão dessa estrutura.

ComponentCount

O número de elementos na matriz Components no final dessa estrutura. Essa contagem inclui todos os elementos da matriz e inclui o primeiro elemento, que é um membro dessa estrutura, e quaisquer elementos adicionais que seguem o final dessa estrutura.

ComponentActiveConditionCallback

Um ponteiro para uma rotina de retorno de chamada ComponentActiveConditionCallback . A PoFx chama essa rotina para notificar o driver de que o componente especificado concluiu uma transição da condição ociosa para a condição ativa.

ComponentIdleConditionCallback

Um ponteiro para uma rotina de retorno de chamada ComponentIdleConditionCallback . A PoFx chama essa rotina para notificar o driver de que o componente especificado concluiu uma transição da condição ativa para a condição ociosa.

ComponentCriticalTransitionCallback

Um ponteiro para uma rotina de retorno de chamada ComponentCriticalTransitionCallback . A PoFx chama essa rotina para notificar o driver de que o componente especificado está prestes a fazer uma transição entre a condição ociosa e a condição ativa.

ComponentIdleStateCallback

Um ponteiro para uma rotina de retorno de chamada ComponentIdleStateCallback . A PoFx chama essa rotina para notificar o driver de uma alteração pendente no estado de energia Fx do componente especificado.

DeviceContext

Um ponteiro para um contexto de dispositivo definido por PEP. O PoFx fornece esse ponteiro como o primeiro parâmetro em chamadas para as rotinas ComponentActiveConditionCallback, ComponentIdleConditionCallback, ComponentCriticalTransitionCallback e ComponentIdleStateCallback . Esse contexto é opaco para PoFx.

Components[ANYSIZE_ARRAY]

O primeiro elemento em uma matriz de estruturas PO_FX_COMPONENT . Cada elemento na matriz descreve os atributos de energia de um componente no dispositivo. Se a matriz contiver mais de um elemento, os elementos adicionais seguirão imediatamente o final da estrutura PO_FX_CORE_DEVICE . O número de elementos na matriz é especificado no membro ComponentCount da estrutura PO_FX_CORE_DEVICE .

Comentários

Essa estrutura é usada pela rotina PoFxRegisterCoreDevice .

Um recurso do sistema principal é um dispositivo de hardware, como um temporizador ou um controlador de interrupção, que é gerenciado pela HAL (camada de abstração de hardware) do Windows.

Para obter mais informações sobre transições de componente entre a condição ativa e a condição ociosa, consulte Gerenciamento de energia no nível do componente.