StorPortGetScatterGatherList 函数 (storport.h)

项目
08/07/2023

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请求结构。