次の方法で共有


PO_FX_DEVICE_V2構造体 (wdm.h)

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

構文

typedef struct _PO_FX_DEVICE_V2 {
  ULONG                                      Version;
  ULONGLONG                                  Flags;
  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;
  ULONG                                      ComponentCount;
  PO_FX_COMPONENT_V2                         Components[ANYSIZE_ARRAY];
} PO_FX_DEVICE_V2, *PPO_FX_DEVICE_V2;

メンバーズ

Version

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

Flags

0 に設定します。 現在、このメンバーにはフラグは定義されていません。

ComponentActiveConditionCallback

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

ComponentIdleConditionCallback

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

ComponentIdleStateCallback

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

DevicePowerRequiredCallback

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

DevicePowerNotRequiredCallback

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

PowerControlCallback

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

DeviceContext

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

ComponentCount

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

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 を含む)

関連項目

ComponentActiveConditionCallback

ComponentIdleConditionCallback

ComponentIdleStateCallback

DevicePowerNotRequiredCallback

DevicePowerRequiredCallback

PO_FX_COMPONENT

PoFxActivateComponent

PoFxCompleteIdleCondition

PoFxRegisterDevice

PowerControlCallback