StorPortGetScatterGatherList ルーチンは、指定された SCSI 要求ブロック (SRB) の関連する散布図/収集リストを取得します。
構文
STORPORT_API PSTOR_SCATTER_GATHER_LIST StorPortGetScatterGatherList(
[in] PVOID HwDeviceExtension,
[in] PSCSI_REQUEST_BLOCK Srb
);
パラメーター
[in] HwDeviceExtension
ハードウェア デバイス拡張機能へのポインター。 これは、ポート ドライバーが割り当て、ミニポート ドライバーの代わりに初期化する HBA ごとの記憶域です。 ミニポート ドライバーは通常、HBA の状態や HBA のマップされたアクセス範囲など、この拡張機能に HBA 固有の情報を格納します。 この領域は、ミニポート ドライバーが StorPortInitialize 呼び出した直後にミニポートで使用できます。 ポート ドライバーは、デバイスを削除すると、このメモリを解放します。
[in] Srb
散布図収集リストを構築する SRB へのポインター。
戻り値
StorPortGetScatterGatherList 、散布図/収集リストへのポインターを返します。
備考
このルーチンは、Storport ドライバー ライブラリで提供されます。 SCSI ポート ライブラリには並列ルーチンが用意されていません。
返される散布図/収集リストへのポインターは、SRB が完了するまで有効です。
ミニポート ドライバーは、StorPortGetScatterGatherList 返 散布図/収集リストのメモリを解放する必要はありません。
ミニポート ドライバーは、散布図/収集リストを変更できません。
Windows 8 以降では、Srb パラメーターは、SCSI_REQUEST_BLOCK または STORAGE_REQUEST_BLOCKを指している可能性があります。 Srb の Function フィールドの関数識別子SRB_FUNCTION_STORAGE_REQUEST_BLOCK場合、SRB は STORAGE_REQUEST_BLOCK 要求構造体です。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | storport.h (Storport.h を含む) |
| ライブラリ | Storport.lib |