PO_FX_CORE_DEVICE结构（pepfx.h）

项目
02/07/2025

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 成员中指定的。