StorPortGetScatterGatherList 函式 (storport.h)
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 要求結構。
要求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
標頭 | storport.h (包括 Storport.h) |
連結庫 | Storport.lib |