StorPortGetScatterGatherList 関数 (storport.h)

[アーティクル]
02/26/2024

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要求構造体です。