PO_FX_CORE_DEVICE 结构 (pep_x.h)

项目
02/26/2024

PO_FX_CORE_DEVICE 结构包含有关核心系统资源中组件的电源状态属性的信息，并提供用于管理这些组件的电源的软件接口。

语法

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;

成员

Version

此结构的版本号。

ComponentCount

此结构末尾的 Components 数组中的元素数。此计数包括数组的所有元素，并且包括作为此结构的成员的第一个元素，以及此结构末尾之后的任何其他元素。

ComponentActiveConditionCallback

指向 ComponentActiveConditionCallback 回调例程的指针。 PoFx 调用此例程以通知驱动程序指定的组件已完成从空闲条件到活动条件的转换。

ComponentIdleConditionCallback

指向 ComponentIdleConditionCallback 回调例程的指针。 PoFx 调用此例程以通知驱动程序指定的组件已完成从活动条件到空闲条件的转换。

ComponentCriticalTransitionCallback

指向 ComponentCriticalTransitionCallback 回调例程的指针。 PoFx 调用此例程以通知驱动程序指定的组件即将在空闲条件和活动条件之间进行转换。

ComponentIdleStateCallback

指向 ComponentIdleStateCallback 回调例程的指针。 PoFx 调用此例程以通知驱动程序对指定组件的 Fx 电源状态的挂起更改。

DeviceContext

指向 PEP 定义的设备上下文的指针。 PoFx 提供此指针作为对 ComponentActiveConditionCallback、 ComponentIdleConditionCallback、 ComponentCriticalTransitionCallback 和 ComponentIdleStateCallback 例程的调用中的第一个参数。此上下文对 PoFx 不透明。

Components[ANYSIZE_ARRAY]

PO_FX_COMPONENT结构数组中的第一个元素。数组中的每个元素都描述设备中某个组件的电源属性。如果数组包含多个元素，则附加元素将紧跟 在PO_FX_CORE_DEVICE 结构的末尾。数组中的元素数在 PO_FX_CORE_DEVICE 结构的 ComponentCount 成员中指定。