estructura de PO_FX_CORE_DEVICE (pep_x.h)

Artículo
08/07/2023

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 ComponentActiveConditionCallback . PoFx llama a esta rutina para notificar al controlador que el componente especificado completó una transición de la condición inactiva a la condición activa.

ComponentIdleConditionCallback

Puntero a una rutina de devolución de llamada ComponentIdleConditionCallback . 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 una rutina de devolución de llamada ComponentCriticalTransitionCallback . 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 inactiva y la condición activa.

ComponentIdleStateCallback

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

DeviceContext

Puntero a un contexto de dispositivo definido por PEP. PoFx proporciona este puntero como primer parámetro en las llamadas a las rutinas ComponentActiveConditionCallback, ComponentIdleConditionCallback, ComponentCriticalTransitionCallback y ComponentIdleStateCallback . 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 al final de la estructura de PO_FX_CORE_DEVICE . El número de elementos de la matriz se especifica en el miembro ComponentCount de la estructura PO_FX_CORE_DEVICE .

Comentarios

Esta estructura la usa 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 (HAL) de Windows.

Para obtener más información sobre las transiciones de componente entre la condición activa y la condición inactiva, consulte Administración de energía de nivel de componente.