PO_FX_CORE_DEVICE 構造体 (pep_x.h)

[アーティクル]
08/07/2023

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 メンバーで指定されます。