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