estructura PO_FX_CORE_DEVICE (pepfx.h)

Artículo
02/07/2025

La estructura de PO_FX_CORE_DEVICE contiene información sobre los atributos de estado de energía de los componentes de un recurso del sistema principal y proporciona una interfaz de software para administrar estos componentes con energía.

Sintaxis

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;

Miembros

Version

Número de versión de esta estructura.

ComponentCount

Número de elementos de la matriz Components al final de esta estructura. Este recuento incluye todos los elementos de la matriz e incluye el primer elemento, que es miembro de esta estructura, y los elementos adicionales que siguen al final de esta estructura.

ComponentActiveConditionCallback

Puntero a una rutina de devolución de llamada ComponentActiveConditionCall back. PoFx llama a esta rutina para notificar al controlador que el componente especificado completó una transición de la condición de inactividad a la condición activa.

ComponentIdleConditionCallback

Puntero a un ComponentIdleConditionCallback rutina de devolución de llamada. PoFx llama a esta rutina para notificar al controlador que el componente especificado completó una transición de la condición activa a la condición inactiva.

ComponentCriticalTransitionCallback

Puntero a un ComponentCriticalTransitionCallback rutina de devolución de llamada. PoFx llama a esta rutina para notificar al controlador que el componente especificado está a punto de realizar una transición entre la condición de inactividad y la condición activa.

ComponentIdleStateCallback

Puntero a un ComponentIdleStateCallback rutina de devolución de llamada. PoFx llama a esta rutina para notificar al controlador un cambio pendiente a Fx estado de energía del componente especificado.

DeviceContext

Puntero a un contexto de dispositivo definido por PEP. PoFx proporciona este puntero como primer parámetro en las llamadas al ComponentActiveConditionCallback, ComponentIdleConditionCallback, ComponentCriticalTransitionCallbacky ComponentIdleStateCallback rutinas. Este contexto es opaco para PoFx.

Components[ANYSIZE_ARRAY]

Primer elemento de una matriz de estructuras de PO_FX_COMPONENT. Cada elemento de la matriz describe los atributos de energía de un componente del dispositivo. Si la matriz contiene más de un elemento, los elementos adicionales siguen inmediatamente el final de la estructura PO_FX_CORE_DEVICE. El número de elementos de la matriz se especifica en el ComponentCount miembro de la estructura PO_FX_CORE_DEVICE.

Observaciones

Esta estructura se usa en la rutina PoFxRegisterCoreDevice.

Un recurso del sistema principal es un dispositivo de hardware, como un temporizador o un controlador de interrupción, administrado por la capa de abstracción de hardware de Windows (HAL).

Para obtener más información sobre las transiciones de componente entre la condición activa y la condición de inactividad, consulte Component-Level Power Management.