PO_FX_CORE_DEVICE estrutura (pepfx.h)

Artigo
02/07/2025

A estrutura PO_FX_CORE_DEVICE contém informações sobre os atributos de estado de energia dos componentes em um recurso do 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 componentes 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 um ComponentActiveConditionCallback rotina de retorno de chamada. 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 um ComponentIdleConditionCallback rotina de retorno de chamada. 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 um ComponentCriticalTransitionCallback rotina de retorno de chamada. 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 um ComponentIdleStateCallback rotina de retorno de chamada. A PoFx chama essa rotina para notificar o driver de uma alteração pendente para o estado de energia do 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 o ComponentActiveConditionCallback, ComponentIdleConditionCallback, ComponentCriticalTransitionCallbacke rotinas de 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.

Observações

Essa estrutura é usada pela rotina PoFxRegisterCoreDevice.

Um principal recurso do sistema é 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 Component-Level Power Management.