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 |