StorPortInitializePoFxPower 関数 (storport.h)

  • [アーティクル]

ミニポート ドライバーは 、StorPortInitializePoFxPower を呼び出して、記憶域デバイスを電源管理フレームワーク (PoFx) に登録します。

構文

ULONG StorPortInitializePoFxPower(
  [in]           PVOID             HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS     Address,
  [in]           PSTOR_POFX_DEVICE Device,
  [in, out]      PBOOLEAN          D3ColdEnabled
);

パラメーター

[in] HwDeviceExtension

ホスト バス アダプター (HBA) のハードウェア デバイス拡張機能へのポインター。

[in, optional] Address

記憶装置ユニットのアドレス。 ストレージ アダプターに登録する場合、このパラメーターは NULL です 。

[in] Device

STOR_POFX_DEVICEへのポインターにキャストされたSTOR_POFX_DEVICE_V2構造体へのポインター。 この構造体には、ストレージ デバイスの F 状態を含むコンポーネント リストが含まれています。

[in, out] D3ColdEnabled

ストレージ デバイスに対して D3 コールド状態が有効になっているかどうかを示すために Storport ドライバーが設定する ブール 値へのポインター。

戻り値

StorPortInitializePoFxPower ルーチンは、次のいずれかの状態コードを返します。

リターン コード 説明
STOR_STATUS_INVALID_PARAMETER
 HwDeviceExtension または Device が NULL です。

または

アドレス は、無効なユニット アドレス構造を指しています。

または

Address で指定されたストレージ デバイスが見つかりません。

または

Device が指すSTOR_POFX_DEVICE構造が正しく書式設定されていないか、無効なデータが含まれています。
STOR_STATUS_SUCCESS
 ストレージ デバイスが PoFx に正常に登録されました。
STOR_STATUS_INSUFFICIENT_RESOURCES
 ストレージ デバイスを PoFx に登録するのに十分なリソースを使用できません。
STOR_STATUS_UNSUCCESSFUL
 ストレージ デバイスが PoFx に正常に登録されませんでした。

または

ストレージ デバイスは PoFx に既に登録されています。

注釈

アダプター デバイスは、常にアドレスの NULL 値で登録されます。 ユニット デバイスは、 アドレスの有効な単位アドレスを指定して登録されます。

STOR_POFX_DEVICE_FLAG_ENABLE_D3_COLD フラグが Device の Flags メンバーに設定されている場合、Storport はデバイス コンポーネントの D3 コールド サポートを有効にしようとします。 D3 コールド対応状態は、D3ColdEnabled が指す BOOLEAN 値で返されます。

要件

要件 値
サポートされている最小のクライアント Windows 8 以降で使用できます。
対象プラットフォーム ユニバーサル
Header storport.h

こちらもご覧ください

STOR_POFX_DEVICE