StorPortPoFxActivateComponent ルーチンは、ストレージ デバイスの指定されたコンポーネントのアクティブ化参照カウントをインクリメントします。
構文
ULONG StorPortPoFxActivateComponent(
[in] PVOID HwDeviceExtension,
[in, optional] PSTOR_ADDRESS Address,
[in, optional] PSCSI_REQUEST_BLOCK Srb,
[in] ULONG Component,
[in] ULONG Flags
);
パラメーター
[in] HwDeviceExtension
ホスト バス アダプター (HBA) のハードウェア デバイス拡張機能へのポインター。
[in, optional] Address
記憶装置ユニットのアドレス。 このパラメーターは、ストレージ・アダプター・コンポーネントをアクティブ化するときに NULL されます。
[in, optional] Srb
コンポーネントのアクティブ化をトリガーする SRB。 ミニポートが Storport 経由で送信されない要求のデバイス コンポーネントをアクティブ化している場合、このパラメーターは NULL 。
[in] Component
コンポーネントを識別するインデックス。 このパラメーターは、ミニポート ドライバーが StorPortInitializePoFxPower への呼び出しでデバイスに登録された STOR_POFX_DEVICE 構造体のコンポーネント 配列へのインデックスです。 Components 配列に N 個の要素が含まれている場合、コンポーネントインデックスの範囲は 0 から N ~ 1 です。
[in] Flags
使用されません。 0 に設定します。
戻り値
StorPortPoFxActivateComponent ルーチンは、次のいずれかの状態コードを返します。
| リターン コード | 形容 |
|---|---|
|
ストレージ デバイスのアクティブ化参照が正常にインクリメントされ、コンポーネントがアクティブな状態になっています。 |
|
HwDeviceExtension するか、デバイス NULL です。
-又は- アドレス は、無効なユニット アドレス構造を指しています。 -又は- アドレス で指定されたストレージ デバイスが見つかりません。 -又は- ストレージ デバイスは、電源管理フレームワーク (PoFx) に登録されていません。 -又は- Srb が指す SRB は Storport から送信されません。 -又は- Flags パラメーターは 0 以外です。 |
|
アダプターまたはユニットは PoFx をサポートしていません。 |
|
現在の IRQL > DISPATCH_LEVEL。 |
|
ストレージ デバイスのアクティブ化参照は正常にインクリメントされましたが、コンポーネントはまだアイドル状態です |
備考
現在、アダプター デバイスとユニット デバイスの両方のコンポーネントの最大数は 1 です。 コンポーネント のインデックスは常に 0 に設定する必要があります。
StorPortPoFxActivateComponent の各呼び出しは、StorPortPoFxIdleComponent への後続の呼び出し照合する必要があります。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 8 以降で使用できます。 |
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | storport.h |
| ライブラリ | Storport.lib |
| IRQL | IRQL <= DISPATCH_LEVEL |
関連項目
StorPortInitializePoFxPower の
StorPortPoFxIdleComponent の