PO_FX_DEVICE_V1 構造体 (wdm.h)

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

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を返します。