PO_FX_DEVICE_V1構造体 (wdm.h)

[アーティクル]
02/07/2025

PO_FX_DEVICE 構造体は、電源管理フレームワーク (PoFx) に対するデバイスの電源属性を記述します。

構文

typedef struct _PO_FX_DEVICE_V1 {
  ULONG                                      Version;
  ULONG                                      ComponentCount;
  PPO_FX_COMPONENT_ACTIVE_CONDITION_CALLBACK ComponentActiveConditionCallback;
  PPO_FX_COMPONENT_IDLE_CONDITION_CALLBACK   ComponentIdleConditionCallback;
  PPO_FX_COMPONENT_IDLE_STATE_CALLBACK       ComponentIdleStateCallback;
  PPO_FX_DEVICE_POWER_REQUIRED_CALLBACK      DevicePowerRequiredCallback;
  PPO_FX_DEVICE_POWER_NOT_REQUIRED_CALLBACK  DevicePowerNotRequiredCallback;
  PPO_FX_POWER_CONTROL_CALLBACK              PowerControlCallback;
  PVOID                                      DeviceContext;
  PO_FX_COMPONENT_V1                         Components[ANYSIZE_ARRAY];
} PO_FX_DEVICE_V1, *PPO_FX_DEVICE_V1;

メンバーズ

Version

この構造体のバージョン番号。ドライバーが PoFx でパフォーマンス状態のサポートに登録する場合は、このメンバーを PO_FX_VERSION_V2に設定します。それ以外の場合は、このメンバーを PO_FX_VERSION_V1に設定します。

ComponentCount

Components 配列内の要素の数。さらに、このメンバーは、デバイス内のコンポーネントの数を指定します。

ComponentActiveConditionCallback

ComponentActiveConditionCallback デバイスドライバーによって実装されるコールバックルーチンへのポインター。

ComponentIdleConditionCallback

ComponentIdleConditionCallback デバイスドライバーによって実装されるコールバックルーチンへのポインター。

ComponentIdleStateCallback

ComponentIdleStateCallback デバイスドライバーによって実装されるコールバックルーチンへのポインター。

DevicePowerRequiredCallback

DevicePowerRequiredCallback デバイスドライバーによって実装されるコールバックルーチンへのポインター。

DevicePowerNotRequiredCallback

DevicePowerNotRequiredCallback デバイスドライバーによって実装されるコールバックルーチンへのポインター。

PowerControlCallback

デバイスドライバーによって実装される PowerControlCallback コールバックルーチンへのポインター。

DeviceContext

呼び出し元によって割り当てられたデバイスコンテキストへのポインター。このポインターは、この構造体が指す各ドライバー実装コールバック関数にパラメーターとして渡されます。デバイスドライバーは、このコンテキストを使用して、デバイスの現在の電源状態に関する情報を格納します。このコンテキストは PoFx に対して不透明です。

Components[ANYSIZE_ARRAY]

このメンバーは、1 つ以上の PO_FX_COMPONENT 要素の配列の最初の要素です。配列に複数の要素が含まれている場合、追加の要素は PO_FX_DEVICE 構造体のすぐ後に続きます。配列には、デバイス内のコンポーネントごとに 1 つの要素が含まれています。各コンポーネントの Fx 電源状態は、デバイス内の他のコンポーネントの Fx 電源状態とは無関係に制御できます。 ANYSIZE_ARRAY 定数は、Ntdef.h ヘッダーファイルで 1 に定義されています。

備考

デバイスを PoFx に登録するには、ドライバーは、PoFxRegisterDevice ルーチンを呼び出し、パラメーターとして、デバイスを記述する PO_FX_DEVICE 構造体へのポインターを提供します。

Components 配列内の各要素は、デバイス内の 1 つのコンポーネントの電源状態属性を記述します。デバイス内の各コンポーネントは、Components 配列インデックスによって識別されます。 PoFxActivateComponent や PoFxCompleteIdleCondition などのルーチンでは、コンポーネントの配列インデックスを使用してコンポーネントを識別。

デバイスドライバーは、6 つのコールバックルーチンをすべて実装する必要はありません。ドライバーが対応するコールバックルーチンを実装していない場合、ドライバーは、PO_FX_DEVICE 構造体の関数ポインターを NULL に設定できます。ただし、特定のコールバックルーチンを実装する必要があります。具体的には、デバイス内の 1 つ以上のコンポーネントに複数の Fx 状態がある場合、ドライバーは ComponentIdleStateCallback 、ComponentActiveConditionCallback、および ComponentIdleConditionCallback ルーチン実装する必要があります。それ以外の場合、デバイスの登録が失敗し、PoFxRegisterDevice STATUS_INVALID_PARAMETERが返されます。

必要条件

要件	価値
サポートされる最小クライアント	Windows 8 以降でサポートされています。
ヘッダー	wdm.h (Wudfwdm.h を含む)

次の方法で共有

PO_FX_DEVICE_V1構造体 (wdm.h)

構文

メンバーズ

備考

必要条件

関連項目

フィードバック

その他のリソース