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