PMAP_TRANSFER回调函数 (wdm.h)

项目
03/05/2024

MapTransfer 例程为适配器对象设置映射寄存器，以映射锁定缓冲区中的 DMA 传输。

语法

PMAP_TRANSFER PmapTransfer;

PHYSICAL_ADDRESS PmapTransfer(
  [in]      PDMA_ADAPTER DmaAdapter,
  [in]      PMDL Mdl,
  [in]      PVOID MapRegisterBase,
  [in]      PVOID CurrentVa,
  [in, out] PULONG Length,
  [in]      BOOLEAN WriteToDevice
)
{...}

参数

[in] DmaAdapter

指向 IoGetDmaAdapter 返回的 DMA 适配器对象的指针，该对象以前传递给 AllocateAdapterChannel 以用于当前 IRP 的传输请求。

[in] Mdl

指向以下项之一的指针：描述当前 IRP 中 MdlAddress 处的缓冲区的 MDL，或描述从属设备的驱动程序 (自动初始化模式) 设置的公共缓冲区的 MDL。

[in] MapRegisterBase

指定为 DMA 操作分配的映射寄存器。系统将此值传递给驱动程序的 AdapterControl 例程。

[in] CurrentVa

指向要为 DMA 传输操作传输的数据的当前虚拟地址的指针。

[in, out] Length

指定要映射的长度（以字节为单位）。如果驱动程序在调用 IoGetDmaAdapter 时指示其设备是支持散点/收集的总线主机，则从 MapTransfer 返回时的 Length 值指示映射了多少字节。否则， Length 的输入和输出值是相同的。

[in] WriteToDevice

指示传输操作的方向：对于从锁定的缓冲区到设备的传输，为 TRUE 。

返回值

MapTransfer 返回映射的区域的逻辑地址，总线-主适配器的驱动程序可以使用该地址。使用系统 DMA 控制器的设备驱动程序不能使用此值，应忽略此值。

注解

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

由于驱动程序先前调用 AllocateAdapterChannel，DmaAdapter 必须已分配。

可以设置的映射寄存器数不能超过驱动程序调用 IoGetDmaAdapter 时返回的最大值。

驱动程序可以通过调用 MmGetMdlVirtualAddress 获取开始基于数据包的 DMA 传输的初始 CurrentVa。但是，返回的值是 Mdl 中的索引，而不是有效的虚拟地址。如果驱动程序必须将大型传输请求拆分为多个 DMA 操作，则必须为每个 DMA 操作更新 CurrentVa 和 Length 。

支持散点/收集的总线主设备的驱动程序可以使用返回的逻辑地址和更新的 Length 值来生成散点/收集列表，并重复调用 MapTransfer ，直到它已使用所有可用的映射寄存器进行传输操作。但是，此类驱动程序可以更简单地使用 GetScatterGatherList 例程。

要求

要求	值
最低受支持的客户端	从 Windows 2000 开始可用。
目标平台	桌面
标头	wdm.h（包括 Wdm.h、Ntddk.h、Ntifs.h）
IRQL	<= DISPATCH_LEVEL
DDI 符合性规则	IrqlDispatch (wdm)