StorPortPoFxSetComponentResidency 関数 (storport.h)

  • [アーティクル]

StorPortPoFxSetComponentResidency ルーチンは、コンポーネントがアイドル状態に入った後にストレージ デバイス コンポーネントがアイドル状態のままになる可能性が高い期間の推定時間を設定します。

構文

ULONG StorPortPoFxSetComponentResidency(
  [in]           PVOID         HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS Address,
  [in]           ULONG         Component,
  [in]           ULONGLONG     Residency
);

パラメーター

[in] HwDeviceExtension

ホスト バス アダプター (HBA) のハードウェア デバイス拡張機能へのポインター。 これは、 StorPortInitializePoFxPower の以前の呼び出しでデバイスを登録するために使用されるデバイス拡張機能です。

[in, optional] Address

記憶装置ユニットのアドレス。 ストレージ アダプター コンポーネントの保存場所を設定する場合、このパラメーターは NULL です 。

[in] Component

コンポーネントを識別するインデックス。 このパラメーターは、ミニポート ドライバーが StorPortInitializePoFxPower の呼び出しでデバイスに登録されたSTOR_POFX_DEVICE構造体の Components 配列へのインデックスです。 Components 配列に N 個の要素が含まれている場合、コンポーネントインデックスの範囲は 0 から N ~ 1 です。

[in] Residency

推定滞在時間 (100 ナノ秒単位)。 このパラメーターは、アクティブな条件からアイドル状態への移行後にコンポーネントがアイドル状態のままになる可能性が高い期間に関する電源管理フレームワーク (PoFx) のヒントです。

戻り値

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

リターン コード 説明
STOR_STATUS_SUCCESS
 コンポーネントの所在地が正常に設定されました。
STOR_STATUS_INVALID_PARAMETER
 HwDeviceExtension または Device が NULL です。

または

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

または

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

または

Component のインデックスは、デバイスのコンポーネント数よりも大きいコンポーネントを指定します。
STOR_STATUS_INVALID_DEVICE_REQUEST
 ストレージ デバイスが PoFx に登録されていません。
STOR_STATUS_INVALID_IRQL
 現在の IRQL > DISPATCH_LEVEL。

要件

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

こちらもご覧ください

PoFxSetComponentResidency