StorPortGetScatterGatherList 函式 (storport.h)

發行項
02/29/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的函式欄位中的函式識別碼是SRB_FUNCTION_STORAGE_REQUEST_BLOCK，SRB 是STORAGE_REQUEST_BLOCK要求結構。