次の方法で共有

STOR_POFX_DEVICE構造体 (storport.h)

  • [アーティクル]

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

構文

typedef struct _STOR_POFX_DEVICE {
  ULONG               Version;
  ULONG               Size;
  ULONG               ComponentCount;
  ULONG               Flags;
  STOR_POFX_COMPONENT Components[ANYSIZE_ARRAY];
} STOR_POFX_DEVICE, *PSTOR_POFX_DEVICE;

メンバーズ

Version

この構造体のバージョン番号。 このメンバーを STOR_POFX_DEVICE_VERSION_V1に設定します。

Size

この構造体のサイズ。 この値を STOR_POFX_DEVICE_SIZEに設定します。

ComponentCount

Components 配列内の要素の数。 このメンバーを 1 に設定します。 現時点では、1 つのコンポーネントのみがストレージ・アダプターまたは論理装置に対してサポートされています。

Flags

デバイスの電源状態機能フラグ。 ミニポートは、電源状態機能を有効または無効にする PoFx デバイス フラグの 1 つ以上を設定します。

フラグ は、次のビットごとの OR の組み合わせです。

価値 意味
STOR_POFX_DEVICE_FLAG_DISABLE_INTERRUPTS_ON_D3
 設定すると、Storport は、アダプターを D3 に配置するときに割り込みを無効にし、D0 に再開するときに割り込みを再アクティブ化することを指定します。
STOR_POFX_DEVICE_FLAG_ENABLE_D3_COLD
 Storport がアダプターをサポートしている場合に、アダプターの D3 コールド状態を設定できるようにします。 このフラグはアダプターにのみ適用されます。
STOR_POFX_DEVICE_FLAG_NO_D0
 アダプターまたはユニットのデバイス オブジェクトに電源投入 IRP を送信しないことを要求します。
STOR_POFX_DEVICE_FLAG_NO_D3
 アダプターまたはユニットのデバイス オブジェクトに電源を切る IRP を送信しないことを要求します。
STOR_POFX_DEVICE_FLAG_NO_DUMP_ACTIVE
 デバイスがアイドル状態になった場合、またはアイドル状態のときに電源がオフになった場合、ミニポートは、ダンプ モードでアクティブな記憶域デバイスを持ち込むことができません。 このフラグは、デバイスがアイドル状態のときにダンプに使用できるかどうかを示します。

Components[ANYSIZE_ARRAY]

このメンバーは、1 つ以上の STOR_POFX_COMPONENT 要素の配列の最初の要素です。 配列に複数の要素が含まれている場合、追加の要素は STOR_POFX_DEVICE 構造体のすぐ後に続きます。 配列には、デバイス内のコンポーネントごとに 1 つの要素が含まれています。 現時点では、ストレージ デバイスにはコンポーネントが 1 つしかないため、追加のコンポーネント構造は不要です。

備考

Storport PoFx サポート用のストレージ アダプターを登録するために、ミニポート ドライバーは、HwStorInitialize ルーチンで StorPortEnablePassiveInitialization を呼び出し、HwStorPassiveInitializeRoutineを実装します。 ミニポートは 、HwStorPassiveInitializeRoutine 内の StorPortInitializePoFxPower を呼び出して、アダプター コンポーネントに関する情報を提供します。

Storport PoFx サポート用のストレージ ユニットを登録するために、ミニポート ドライバーは、HwStorUnitControl コールバック ルーチンを実装し、ScsiUnitPoFxPowerInfo ユニット制御コードの処理を提供します。 コントロール コード ScsiUnitPoFxPowerInfo 処理する場合、ユニット コンポーネントのアイドル状態の電源管理が有効になっている場合、ミニポートは StorPortInitializePoFxPower を呼び出します。

Components 配列インデックスによって識別されるストレージ デバイスのコンポーネント。 ストレージ デバイスにはコンポーネントが 1 つしかないため、インデックス 0 が使用されます。 StorPortPoFxActivateComponent や StorPortPoFxIdleComponent などのルーチンでは、コンポーネントの配列インデックスを使用してコンポーネントを識別。

必要条件

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

関連項目

STOR_POFX_COMPONENT

StorPortInitializePoFxPower の

StorPortPoFxActivateComponent の

StorPortPoFxIdleComponent の