WDF驱动开发-DMA(四)

最新推荐文章于 2024-07-05 15:58:58 发布

sului

最新推荐文章于 2024-07-05 15:58:58 发布

阅读量661

点赞数 26

分类专栏： WDF驱动开发文章标签：驱动开发

本文链接：https://blog.csdn.net/m0_72813396/article/details/139908502

版权

WDF驱动开发专栏收录该内容

39 篇文章 3 订阅

订阅专栏

支持系统模式 DMA

与总线主 DMA 相比，系统模式 DMA 描述了一种配置，其中多个设备共享单个（通常是多通道）DMA 控制器。

从 Kernel-Mode Driver Framework (KMDF) 版本 1.11 开始，该框架支持在 Windows 8 或更高版本的 Windows 操作系统上运行的基于 Windows 8 或更高版本的基于系统的芯片 SoC 上的系统上的系统模式 DMA。

下面介绍 KMDF 驱动程序必须在其事件回调函数中提供的代码，以及它可以注册的可选事件回调函数，以处理系统模式 DMA 设备的 I/O 请求。

下图显示了驱动程序用于支持系统模式 DMA 的事件回调函数：

创建 System-Mode DMA 启用程序

创建系统模式 DMA 配置文件的过程分为两步，以下步骤表示一个典型方案：

1. 通常，在其 EvtDriverDeviceAdd 回调函数中，驱动程序调用 WDF_DMA_ENABLER_CONFIG_INIT，将 Profile 参数设置为 SystemMode 或 SystemModeDuplex。然后，驱动程序调用 WdfDmaEnablerCreate，传递它刚刚收到的 WDF_DMA_ENABLER_CONFIG 结构。

驱动程序还可以在 EvtDevicePrepareHardware 期间创建启用程序；

2. 驱动程序的 EvtDevicePrepareHardware 回调函数通过调用 WdfDmaEnablerConfigureSystemProfile 方法将 DMA 启用程序与其 DMA 资源相关联。对于双工启用器，驱动程序调用 WdfDmaEnablerConfigureSystemProfile 两次，一次以配置每个传输方向。

在 EvtDevicePrepareHardware 完成后，驱动程序可以调用 WdfDmaEnablerConfigureSystemProfile，但驱动程序必须在初始化 DMA 事务之前调用此方法；

提供可选的回调函数

通常，KMDF 驱动程序不配置 DMA 通道。但是，在某些情况下，驱动程序可能需要执行特定于通道的配置。例如，驱动程序可以使用以下步骤调用由 DMA 控制器实现的自定义函数：

在驱动程序的请求处理程序之一中，驱动程序调用 WdfDmaTransactionSetChannelConfigurationCallback 来注册 EvtDmaTransactionConfigureDmaChannel 回调函数。
驱动程序的 EvtDmaTransactionConfigureDmaChannel 回调函数调用 WdfDmaEnablerWdmGetDmaAdapter 以检索指向 WDM DMA_ADAPTER的指针。此结构是表示驱动程序的系统模式 DMA 通道的适配器对象。
然后，驱动程序可以调用 ConfigureAdapterChannel 来启用由 DMA 控制器实现的自定义函数。此例程只能由 DMA_OPERATIONS结构中返回的地址中的指针调用。
如果驱动程序的 EvtDmaTransactionConfigureDmaChannel 回调函数成功配置 DMA 通道，则返回 TRUE。
框架调用驱动程序的 EvtProgramDma 回调函数。

接收传输完成通知

与使用总线主控控制器的设备不同，系统模式 DMA 设备的硬件可能不会通过发出中断来发出 DMA 传输完成的信号。

如果设备未引发中断以指示 DMA 传输完成，则驱动程序可以提供 EvtDmaTransactionDmaTransferComplete 事件回调函数，供框架在系统模式 DMA 传输完成时调用。

若要注册此回调函数，驱动程序从其请求处理程序之一调用 WdfDmaTransactionSetTransferCompleteCallback。

取消 DMA 事务

如果驱动程序是使用 1.11 版或更高版本的 KMDF 构建的，并且使用 DMA) 版本 3 的直接内存访问 (在 Windows 8 或更高版本上运行，则驱动程序可以通过调用 WdfDmaTransactionCancel 方法尝试取消挂起的 DMA 事务。

调用 WdfDmaTransactionCancel 时，驱动程序必须确保在调用期间未完成指定的 DMA 事务。驱动程序可以使用以下方法安全地取消事务，无论是在 DMA 通道分配之前，还是在完成一些传输操作之后：

1. 在驱动程序的请求处理程序之一中，驱动程序调用 WdfRequestMarkCancelableEx ，并为 I/O 请求提供 EvtRequestCancel 回调函数。然后，请求处理程序调用 WdfDmaTransactionExecute。

2. 驱动程序的 EvtRequestCancel 回调函数，该函数可能会在调用 WdfRequestMarkCancelEx,调用 WdfDmaTransactionCancel 后立即开始在单独的线程中运行。

3. 如果对 WdfDmaTransactionCancel 的调用发生在对 WdfDmaTransactionExecute 的调用之后，但在 WdfDmaTransactionExecute 方法已启动 DMA 分配之前发生，则事务取消成功， WdfDmaTransactionCancel 返回 TRUE。在这种情况下，驱动程序的 EvtRequestCancel 回调函数必须完成 DMA 事务。 WdfDmaTransactionExecute 返回错误值。

4. 如果在 WdfDmaTransactionExecute 方法启动 DMA 分配后驱动程序调用 WdfDmaTransactionCancel ，则取消事务的尝试将失败，并且 WdfDmaTransactionCancel 返回 FALSE。在这种情况下， WdfDmaTransactionExecute 返回STATUS_SUCCESS，驱动程序的请求处理程序必须完成 DMA 事务。

此时，如果驱动程序使用的是系统模式 DMA，则 EvtRequestCancel 回调函数可能会调用 WdfDmaTransactionStopSystemTransfer 来尝试停止正在进行的系统模式 DMA 传输。

5. WdfDmaTransactionExecute 方法完成 DMA 分配后，框架调用驱动程序的 EvtProgramDma 回调函数，该函数可能会在调用 WdfDmaTransactionExecute 后立即开始在单独的线程中运行。此时，对 WdfDmaTransactionCancel 方法的调用将返回 FALSE。

在 EvtProgramDma 中，驱动程序可以调用 WdfRequestUnmarkCancelable 以结束请求取消的可能性。如果 WdfRequestUnmarkCancelable 返回STATUS_SUCCESS，则回调函数必须对硬件进行编程才能启动传输。如果 WdfRequestUnmarkCancelable 返回STATUS_CANCELLED，则表示请求已取消。在这种情况下， EvtProgramDma 必须调用 WdfDmaTransactionDmaCompletedFinal 才能完成 DMA 事务。

在完成一些传输操作后，驱动程序可以使用同一技术取消 DMA 事务。在这种情况下，驱动程序在调用 WdfDmaTransactionDmaCompleted 之后，但在框架调用 EvtProgramDma 之前调用 WdfDmaTransactionCancel，以便对下一个传输操作进行编程。如果驱动程序在调用 WdfDmaTransactionDmaCompleted 之前调用 WdfDmaTransactionCancel，则 WdfDmaTransactionDmaCompleted 返回 TRUE，表示 DMA 事务已完成。

使用单一传输 DMA

默认情况下，WDF 有时会将单个 DMA 事务拆分为多个 DMA 传输。但是，某些设备无法处理碎片事务，而必须接收单个 DMA 操作中的所有数据。例如，某些 PCI 网络控制器一次需要一个网络数据包，因为它们没有用于缓存和重新组合部分数据的硬件。

从 KMDF 版本 1.19 开始，使用 DMA v3 的 KMDF 驱动程序可以指定它需要单个传输 DMA 事务。驱动程序只能为单个 DMA 事务指定单一传输，也可以为使用指定的 DMA 启用程序创建的所有 DMA 事务指定单一传输。

为特定 DMA 事务设置单次传输

若要为单个事务设置单次传输，请使用以下顺序：

调用 WdfDmaTransactionCreate 或 WdfDmaTransactionRelease。
调用 WdfDmaTransactionSetSingleTransferRequirement。
调用 WdfDmaTransactionInitialize。
如果初始化由于事务碎片而失败，驱动程序可能会使 I/O 请求失败，或者它可以重新排列事务的内存缓冲区并重新初始化事务。
调用 WdfDmaTransactionExecute。
调试驱动程序时，可以使用 !wdfkd.wdfdmatransaction 扩展来确定是否为给定事务对象设置了单个传输。

设置使用特定 DMA 启用程序创建的所有 DMA 事务的单一传输要求

若要为使用给定启用程序创建的所有事务设置单一传输，请在调用WdfDmaEnablerCreate 时在 WDF_DMA_ENABLER_CONFIG_FLAGS 中指定WDF_DMA_ENABLER_CONFIG_REQUIRE_SINGLE_TRANSFER标志。

使用此标志的驱动程序无需在每次创建或重用事务对象时调用 WdfDmaTransactionSetSingleTransferRequirement 。

如果驱动程序重用事务对象，此设置也会保留。

调试时，使用 !wdfkd.wdfdmaenabler 扩展确定是否为给定的 DMA 启用程序对象设置了单一传输。

保留 DMA 资源

通常，基于框架的驱动程序不会提前保留映射寄存器。但是，在某些情况下，司机可能需要提前预留这些资源。

在 Windows 8 或更高版本上运行的基于框架的驱动程序可以为指定数据包或系统配置文件的 DMA 启用程序保留指定数量的映射寄存器。为此，驱动程序调用 WdfDmaTransactionAllocateResources 并注册 EvtReserveDma 回调函数。

框架在已保留映射寄存器和 WDM DMA 适配器的锁时调用驱动程序的 EvtReserveDma 函数。然后，驱动程序可以使用同一事务对象多次初始化和启动事务，然后再最终释放事务对象。若要将 DMA 资源释放回系统，驱动程序会调用 WdfDmaTransactionFreeResources。

若要确定事务所需的映射寄存器数，驱动程序可以在调用 WdfDmaTransactionAllocateResources 之前调用 WdfDmaTransactionGetTransferInfo。驱动程序必须在调用 WdfDmaTransactionGetTransferInfo 之前初始化事务。

以下步骤演示了驱动程序如何保留和释放 DMA 启用程序，以便与指定事务独占使用：

驱动程序接收 I/O 请求;
驱动程序的请求处理程序调用 WdfDmaTransactionCreate 为请求创建 DMA 事务对象;
驱动程序的请求处理程序调用 WdfDmaTransactionAllocateResources 来保留资源;
框架在保留请求的资源后调用 EvtReserveDma ;
在 EvtReserveDma 中，驱动程序调用 WdfDmaTransmaTransactionInitializeUsingRequest 或 WdfDmaTransactionInitialize 来初始化事务对象;
在 EvtReserveDma 中，驱动程序调用 WdfDmaTransactionExecute 方法来启动事务。由于事务具有保留的资源，因此框架会立即调用驱动程序的 EvtProgramDma 回调函数;
从 EvtInterruptDpc 或 EvtDmaTransactionDmaTransferComplete，驱动程序调用 WdfDmaTransactionDmaCompleted、 WdfDmaTransactionDmaCompletedWithLength 或 WdfDmaTransactionDmaCompletedFinal，后跟 WdfObjectDelete 或 WdfDmaTransactionRelease。在事务完成或取消之前，驱动程序不得删除或释放事务。完成此步骤后，映射寄存器将保留;
驱动程序可以根据需要多次重复步骤 5-7。当驱动程序不再需要预留时，驱动程序从 EvtInterruptDpc 或 EvtDmaTransactionDmaTransferComplete 调用 WdfDmaTransactionFreeResources。或者，驱动程序可以从其 EvtReserveDma 事件回调函数调用 WdfDmaTransactionFreeResources;