PO_FX_DEVICE_V1構造体 (wdm.h)
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 を含む) |
関連項目
ComponentActiveConditionCallback
ComponentIdleConditionCallback
DevicePowerNotRequiredCallback の
DevicePowerRequiredCallback の
PoFxActivateComponent の
PoFxCompleteIdleCondition の
PoFxRegisterDevice の
PowerControlCallback の