PPUT_SCATTER_GATHER_LIST回调函数 (wdm.h)

PutScatterGatherList 例程释放以前分配的地图寄存器和散点/收集列表,这些寄存器和散点/收集列表用于散点/收集 DMA。

语法

PPUT_SCATTER_GATHER_LIST PputScatterGatherList;

void PputScatterGatherList(
  [in] PDMA_ADAPTER DmaAdapter,
  [in] PSCATTER_GATHER_LIST ScatterGather,
  [in] BOOLEAN WriteToDevice
)
{...}

参数

[in] DmaAdapter

指向 IoGetDmaAdapter 返回的 DMA_ADAPTER 结构的指针,该结构表示总线主适配器或 DMA 控制器。

[in] ScatterGather

指向以前由 GetScatterGatherList返回的 SCATTER_GATHER_LIST 结构的指针。

[in] WriteToDevice

指示 DMA 传输的方向:指定从缓冲区到设备的传输 TRUE,否则 FALSE

返回值

没有

言论

PutScatterGatherList 不是可以直接按名称调用的系统例程。 此例程只能通过从 DMA_OPERATIONS 结构中返回的地址的指针进行调用。 驱动程序通过调用 IoGetDmaAdapter获取此例程的地址。

驱动程序应在完成散点/收集 I/O 后调用 PutScatterGatherList。 此例程刷新适配器缓冲区、释放映射寄存器以及取消映射并释放关联的 MDL。 此外,如果例程以前由 getScatterGatherList分配,则例程释放散点/收集列表。

要求

要求 价值
最低支持的客户端 在 Windows 2000 及更高版本的 Windows 中可用。 Windows 98 或 Windows Me 不支持。
目标平台 桌面
标头 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
IRQL DISPATCH_LEVEL
DDI 符合性规则 IrqlDispatch(storport)、IrqlDispatch(storport)、IrqlDispatch(wdm)

另请参阅

DMA_ADAPTER

DMA_OPERATIONS

GetScatterGatherList

IoGetDmaAdapter

SCATTER_GATHER_LIST