DMA对象

    在Windows 7和更早的版本中，内核模式驱动程序框架(KMDF)只支持bus-master直接内存访问(DMA)设备。这些设备包含它们自己的DMA控制器。

    在运行Windows 8及更高版本的基于SoC的系统平台上，该框架还支持系统模式DMA，即多个设备共享一个多通道DMA控制器。

框架的DMA支持包括:

• 一组框架 DMA 对象和方法，供驱动程序用于将 I/O 请求转换为 DMA 操作。
• 驱动程序提供的事件回调函数，可对设备进行编程以便启动各 DMA 传输操作。

       该框架同时支持单个数据包和分散/集中DMA传输。它还支持使用公共缓冲区。

       在运行Windows 8及更高版本的基于socket的平台上，该框架支持单包系统模式的DMA传输。有关更多信息，请参见支持系统模式DMA。

该框架在pc的平台上不支持系统模式DMA传输。

二，框架DMA对象

若要在基于框架的驱动程序中处理总线主控 DMA 操作，框架提供三个对象：

DMA 启用程序对象（WDFDMAENABLER）

利用框架的 DMA 启用程序对象，驱动程序可以使用框架针对特定设备的 DMA 支持。该驱动程序必须为支持 DMA 操作的每个设备创建一个 DMA 启动程序对象。它说明dma通道特性

DMA 事务对象（WDFDMATRANSACTION）

框架的 DMA 事务对象表示一个 DMA I/O 操作。如果设备使用 DMA 执行请求的操作，则基于框架的驱动程序通常为收到的每个 I/O  请求创建一个 DMA 事务对象。用于dma传输控制。

启动一个DMA传输；

获取DMA传输数据缓冲区物理地址和传输字节数；

DMA传输结束后的数据处理

公用缓冲区对象（WDFDMACOMMONBUFFER）

框架的公用缓冲区对象表示为由驱动程序和设备同时访问映射的计算机内存区域。为 DMA 设备设置 I/O 操作时，一些驱动程序使用公用缓冲区。

三，DMA事务和DMA传输

要理解框架处理总线主控 DMA 操作的工作原理，您必须弄清下面这两个术语：

DMA transaction

一项 DMA 事务是一次完整的 I/O 操作，如来自应用程序的单次读/写请求。

DMA transfer

DMA 传输则是一次硬件操作，它将数据从计算机内存传输到设备，或者反向为之。

一项 DMA 事务总是至少含有一次 DMA 传输，但一项事务可以含有很多次传输。

基于框架的驱动程序收到 I/O 请求时，驱动程序通常都会创建一个 DMA 事务对象来表示该请求。在框架开始为事务提供服务时，它会确定设备是否能在单次传输中处理整项事务。如果事务太大，框架会将事务分拆为多次传输。

四，处理 DMA 设备的 I/O 请求

如果基于框架的驱动程序支持 DMA 设备，则应采用以下步骤来处理需要 DMA 操作的 I/O 请求：

1，驱动程序的  EvtDriverDeviceAdd 或  EvtDevicePrepareHardware回调函数必须针对设备启用 DMA 事务，以使驱动程序可以使用框架的 DMA 功能。如果设备和驱动程序需要访问共享内存缓冲区，则上述相同回调函数还必须创建公用缓冲区。,2，驱动程序收到要求设备执行 DMA 操作的 I/O 请求之后，驱动程序的某个请求处理程序必须创建并初始化新 DMA 事务。然后，请求处理程序必须启动 DMA 事务，使框架可根据需要开始将事务划分为多次较小的 DMA 传输，并且可调用驱动程序的 EvtProgramDma回调函数。

3，驱动程序的 EvtProgramDma  EvtProgramDma回调函数为单一 DMA 传输对 DMA 硬件进行编程programs the DMA hardware并启用设备中断。（如何启动设备中断？？programdma中尚未发现）

4，设备中断后，框架将调用驱动程序的 EvtInterruptIsr 回调函数，这将保存可变设备信息，并安排执行驱动程序的 EvtInterruptDpc 回调函数。（在执行 EvtInterruptDpc 回调函数之前, EvtInterruptIsr 回调函数必须能够对多个中断进行服务。因此, 驱动程序可能必须从多个中断中存储中断数据, 而 EvtInterruptIsr 和EvtInterruptDpc 回调函数可能必须确定驱动程序已完全处理了哪些中断数据, 或者没有。https://docs.microsoft.com/en-us/windows-hardware/drivers/ddi/content/wdfinterrupt/nc-wdfinterrupt-evt_wdf_interrupt_isr）

5，在硬件处理完 DMA 传输之后，驱动程序的 EvtInterruptDpc 回调函数将完成每次 DMA 传输。在完成 DMA 事务的最终传输之后，EvtInterruptDpc 回调函数将完成 DMA 事务。

    驱动程序可以重复使用其 DMA 事务对象，以便确保它们可以在内存资源不足时运行。

    驱动程序可提供一组处理 DMA 特定电源管理操作的回调函数。

    某些驱动程序使用设备和驱动程序均可访问的公用缓冲区。