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) |