使用 WDF 开发驱动程序
本主题简要概述了将用于开发Kernel-Mode驱动程序框架 (KMDF) 驱动程序的框架对象。 除非另有说明,否则你将使用相同的对象从 UMDF 版本 2 开始开发User-Mode驱动程序框架 (UMDF) 驱动程序。
Windows 驱动程序框架 (WDF) 驱动程序由 DriverEntry 例程 和一组事件回调函数组成,这些函数由基于框架的 驱动程序使用的 Windows 驱动程序框架对象 定义。 回调函数调用框架导出的对象方法。 Windows 驱动程序工具包 (WDK) 包含示例 WDF 驱动程序,这些驱动程序演示如何实现驱动程序的事件回调函数。 可以从 Windows 开发人员中心 - 硬件下载这些示例。 有关可用的示例的信息,请参阅 示例 KMDF 驱动程序 和 示例 UMDF 驱动程序。
创建 WDF 驱动程序时,通常会执行以下操作:
使用 框架驱动程序对象 来表示驱动程序。
驱动程序的 DriverEntry 例程 必须调用 WdfDriverCreate 来创建表示驱动程序的框架驱动程序对象。 WdfDriverCreate 方法还会注册驱动程序的 EvtDriverDeviceAdd 回调函数,每次即插即用 (PnP) 管理器报告驱动程序支持的设备是否存在时,框架都会调用该函数。
使用 框架设备对象 支持驱动程序中的 PnP 和电源管理。
所有驱动程序都必须调用 WdfDeviceCreate ,以便为驱动程序支持的每个设备创建框架设备对象。 设备可以是插入计算机的硬件,也可以是仅限软件的设备。 框架设备对象支持 PnP 和电源管理操作,驱动程序可以注册事件回调函数,以便在设备进入或离开其工作状态时通知驱动程序。
有关框架设备对象的详细信息,请参阅 在驱动程序中支持 PnP 和电源管理。
使用 框架队列对象 和 框架请求对象 来支持驱动程序中的 I/O 操作。
接收来自应用程序或其他驱动程序的读取、写入或设备 I/O 控制请求的所有驱动程序都必须调用 WdfIoQueueCreate ,以创建表示 I/O 队列的框架队列对象。 通常,驱动程序为每个 I/O 队列注册一个或多个 请求处理程序 。 当 I/O 管理器向驱动程序发送 I/O 请求时,框架为该请求创建框架请求对象,将请求对象置于 I/O 队列中,并调用驱动程序的请求处理程序之一,以通知驱动程序请求可用。 驱动程序获取 I/O 请求,并且可以重新排队、完成、取消或转发请求。
使用 框架中断对象 处理设备中断。
处理设备中断的驱动程序必须调用 WdfInterruptCreate ,以便为每个中断创建框架中断对象并注册回调函数。 这些回调函数启用和禁用中断,并充当中断 (ISR) 和延迟过程调用 (DPC) 的中断服务例程。
有关框架中断对象的详细信息,请参阅 处理硬件中断。
KMDF 驱动程序可以使用框架的 DMA 启用程序对象 和 DMA 事务对象 来处理设备的直接内存访问 (DMA) 操作。
如果 KMDF 驱动程序的设备支持 DMA 操作,则驱动程序应调用 WdfDmaEnablerCreate 来创建 DMA 启用器对象,并调用 WdfDmaTransactionCreate 来创建一个或多个 DMA 事务对象。 DMA 事务对象定义 EvtProgramDma 回调函数,该函数对设备硬件进行编程以执行 DMA 操作。
有关支持 DMA 操作的详细信息,请参阅 在基于框架的驱动程序中处理 DMA 操作。
使用框架的 I/O 目标对象 将 I/O 请求发送到其他驱动程序。
若要将 I/O 请求传递给其他驱动程序 (通常是驱动程序堆栈) 中的下一个较低驱动程序,驱动程序会将请求发送到 I/O 目标对象。
有关 I/O 目标对象的详细信息,请参阅 使用 I/O 目标。
KMDF 驱动程序可以使用框架的 WMI 提供程序对象 和 WMI 实例对象 来支持 Windows Management Instrumentation (WMI) 功能。
大多数 KMDF 驱动程序应支持 WMI,并且应调用 WdfWmiInstanceCreate 来注册发送或接收 WMI 数据的回调函数。
有关 WMI 的详细信息,请参阅 在基于框架的驱动程序中支持 WMI。
使用框架的同步功能。
所有驱动程序都必须了解多处理器同步问题,并且应使用框架提供的 同步技术 。
使用框架提供的其他对象和功能。
框架提供驱动程序可以使用的其他对象。 有关这些对象的详细信息,请参阅 WDF 支持对象。