次の方法で共有

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 ドライバーが設定する、BOOLEAN 値へのポインター。

戻り値

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

リターン コード 形容
STOR_STATUS_INVALID_PARAMETER
 HwDeviceExtension するか、デバイス NULL です。

-又は-

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

-又は-

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

-又は-

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 以降で使用できます。
ターゲット プラットフォーム の 万国
ヘッダー storport.h

関連項目

STOR_POFX_DEVICE