WDM驱动程序设计 (转)

导读：
　　WDM驱动程序设计 (转)
　　WDM驱动程序设计　作者：汤琳　发布时间：2001/03/14 文章摘要: 　　现在windows98和Windows2000已经成了主流操作系统的主流，原先用来实现驱动程序的VxD技术随着Win95的淡出也慢慢地将退出历史舞台，在Windows98和Windows2000中设备驱动程序将根据Windows驱动程序模型（WDM）来设计。WDM通过提供一种灵活的方式来简化驱动程序的开发，在实现对新硬件支持的基础上减少并降低所必须开发的驱动程序的数量和复杂性。
　　正文: 
　　
　　 WDM驱动程序设计　　
　　一．WDM简介
　　微软不断推出新的操作系统，现在Windows98和Windows2000已经成了主流，原先用来实现驱动程序的VxD技术随着Win95的淡出也慢慢地将退出历史舞台，在Windows98和Windows2000中设备驱动程序将根据Windows驱动程序模型（WDM）来设计。WDM通过提供一种灵活的方式来简化驱动程序的开发，在实现对新硬件支持的基础上减少并降低所必须开发的驱动程序的数量和复杂性。
　　Windows驱动程序模型分两个方面，除了核心模型描述设备驱动程序的标准结构外，WDM还为常见类型的设备实现了一个模块化的、分层次类型的总线驱动程序和类驱动程序。总线驱动程序实现了支持通用串行总线（usb）、IEEE1394（FireWire）协议等。类驱动程序是为实现标准Windows功能提供条件。WDM对标准类接口的支持减少了Windows 95和windows NT所需的设备驱动程序的数量和复杂性。在Windows平台上，WDM将成为21世纪主流的驱动模式。
　　WDM支持USB、IEEE 1394、ACPI等全新的硬件标准。而且以往在两个平台上同时运行时需要编写两个截然不同的驱动程序，现在只需要编写一个WDM驱动程序就可以了。WDM驱动程序也是分层的，即不同层上的驱动程序有着不同的优先级，而Windows 9x下的VxD则没有此结构。
　　DOWNLOADs/BOOK/EMook/china-emook17/china-emook17/0798/1.gif" width=458>
　　
　　WDM还引入了功能设备对象FDO（Functional Device object）与物理设备对象PDO（Physical Device Object）两个新类来描述硬件，一个PDO对应一个真实硬件。一个硬件只允许有一个PDO，却可以拥有多个FDO，在驱动程序中直接操作的不是硬件而是相应的PDO与FDO。在用户态和内核态通讯方面，系统为每一个用户请求打包形成一个IRP结构，将其发送至驱动程序，并通过识别IRP中的PDO来区别是发送给哪一个设备的。另外，在驱动程序的加载方面，WDM不通过驱动程序名称识别，而是通过一个128位的全局唯一标识符GUID来实现驱动程序的识别。我们用上图来说明设备驱动程序的分层及调用。
　　写WDM和其它模式驱动程序基本上是相同的，代码中的主要区别在于如何创建设备。
　　在WDM驱动程序中，即插即用（PnP）管理器告知何时向系统添加一个设备，或者从系统删除设备。PnP管理器使用安装的INF文件查找新设备的正确驱动程序；而其它模式驱动程序必须发现它自己的设备，使用专门的安装程序安装。
　　另外在细节上也存在很多区别，其它模式驱动程序参数一般由注册表提供，在driverEntry里调用读注册表的函数，然后根据注册表再调用CreateDevice，但是WDM一般不是这样，这是由于Windows 2000下支持PnP，在加载的时候PnP管理器调用AddDevice入口点创建设备。一般在DriverEntry里创建的是一个与设备或者对象毫无关系的虚拟设备，用于管理与win32的通讯。如果不想对该设备做什么特别的处理，或者设备不复杂，AddDevice可以简单返回Nt_Success，不用调用CreateDevice。
　　另外整个设备驱动树也发生了改变，从而使安装程序发生了很大的改变。WDM本身的PNP管理器被抽象地提升到了root的地位。PNP管理器负责所有的总线驱动程序的加载。总线驱动程序则负责遍历所有位于总线上的设备，并且为每个设备创建相应的设备对象。当PNP管理器发现一个设备对象，就查找该对象对应的Driver。并调用该Driver的ADD DEVICE例程。如果Driver不在内存中，就先加载，然后调用ADD DEVICE例程。
　　当然，总线本身并没有发出任何信号告诉PNP管理器自己的存在，所以，总线Driver是在NT的安装时设定的。而ISA设备并没有规范，因为需要KMD自己检查硬件存在及状态，所以它是老式KMD存在的惟一理由。这也是微软极力在新规范里取消ISA总线的理由之一。WDM支持PNP协议和PM协议，而且实现时仅仅需要在MAJOR FUNCTION里加入一些对PNP和PM事件响应的例程即可。
　　一个完整的驱动程序要完成以下工作：初始化；创建与删除设备；处理应用层程序的打开和关闭句柄的请求；处理应用层程序的输入/输出请求；串行化对设备的访问；访问硬件；调用其他驱动程序；取消I/O请求；超时I/O请求；处理可热插拔设备的加入和删除事件；电源管理和WMI。
　　 二．开发设备驱动程序
　　2.1设计工具DDK的安装
　　编写WDM设备驱动程序我们需要microsoft的驱动程序开发工具包DDK。尽管微软宣称WDM驱动程序是Windows98和2000之间二进制兼容的，为了安全起见我们还是在不同的系统下仅安装相应的DDK。
　　(一).windows 98DDK的安装
　　这一部分描述如何安装Windows 98 DDK。我们约定%98DDK%为安装Windows 98 DDK的根目录；%MSTOOLS%为微软SDK平台的根目录；%VCPPDEV%为安装的VC++开发环境的根目录。
　　使用DDK的软件平台通常为Windows 98操作系统和VC++ 4.2或5.0版本，若要编译视频捕获示例则需要VC++ 5.0版本。你必须在安装Windows 98 DDK之前先安装VC++编译/开发环境，否则运行时，Windows 98 DDK的Setenv.bat文件将不能建立正确的编译环境 。阅读DDK 文档需要ie4.01以上版本，如果是从光盘或需要测试光盘驱动程序则需要光驱，16MB内存是不可少的，完整安装需要82MB硬盘空间（最小安装需要32MB硬盘空间）。
　　Windows 98 DDK所带的所有驱动程序例子都不需要在安装有SDK的平台下构造。不过，如果你开始开发自己的驱动程序，可能需要Windows 98 DDK中没有而是在SDK平台中的头文件，因此可以考虑两种方法：拷贝所需的头文件或SDK平台的文件到在%98DDK%和%VCPPDEV%下适当的Include 目录中；也可以直接安装SDK平台，编辑%98DDK%BIN中Setenv.bat文件，并运行安装在%MSTOOLS%里的Setenv.bat文件。
　　用Setup程序安装DDK，步骤为：
　　(1)运行Windows 98 DDK中的SETUP.EXE文件，按照对话框提示安装Windows 98 DDK到％98DDK％。
　　(2)安装VC++ 5.0到％VCPPDEV％。
　　(3)修改CONFIG.SYS增大环境变量空间。在CONFIG.SYS文件最后加入一行：
　　shell=C:WINDOWSCOMMAND.com/p /e:4096
　　在安装Windows 98 DDK之前，必须先安装VC++编译器/开发环境，否则运行时，Win
　　dows 98 DDK的Setenv.bat批处理文件将不能建立正确的环境。
　　下面介绍建立Windows 98驱动程序构造环境以及利用构造环境和工具构造驱动程序的方法。
　　1. 用SETENV.BAT来安装驱动程序构造环境
　　开始菜单中有"Development KitsWindows 98 DDK"的目录。这个目录包括自由构造环境项和检查构造环境项。每次重启操作系统，在构造驱动程序前，单击这些程序文件夹中合适的一项。这些项调用%98DDK%BIN里的Setenv.bat批处理文件来创建正确的环境变量的驱动程序构造环境。
　　2. 手工运行SETENV.bat
　　在MS-DOS提示符下，或在"开始/运行"中使用下列语句：
　　setenv　 %98DDK% 　[free | checked]
　　例如，在C:98ddkbin〉提示符下，键入setenv C:98ddk free，其中第一个参数指定DDK被安装的文件夹，注意缺省安装是98ddk；可选的第二个参数说明目标构造环境，缺省类型是free。
　　3. 构造WDM驱动程序
　　使用一系列规则以指定驱动程序怎样被创建，构造实用程序可用来在Windows 98 和Windows NT平台上构造WDM驱动程序。
　　在Windows 98 DDK被安装之后，WDM驱动程序构造树的工作例子和组成部分文件在硬盘上就可以得到了。驱动程序构造树根目录在%98DDK%src。查看%98DDK%inc里Makefile.def文件的内容，以及贯穿驱动程序构造树的各种的Dirs文件和源文件的内容，可以利用这些代码作为工作实例。
　　4.构造驱动程序
　　在当前目录的驱动程序构造树中创建一个子目录，然后，运行构造实用程序。在构造树的当前目录中，构造实用程序可以自动创建出驱动程序的源代码。构造实用程序在Windows 98 DDK例子驱动程序构造树的根目录下（%98DDK%src）运行。例如，如果仅仅对为声音设备类构造的例子驱动程序有兴趣，可以设置当前目录到%98DDK%srcaudio上，然后，运行构造实用程序。
　　5.检查Windows 98 DDK的安装
　　经常使用的构造指令形式为build -cZ ；从而使构造实用程序做相关文件的扫描，执行完整的创建，并生成错误记录。检查安装的方法为：在〈destination〉src目录运行build -cZ，构造安装的例子驱动程序源代码的完整集。这个实用程序在构造驱动程序之前构造全部相关文件，自动建立文件关联关系。这个过程可能需要30多分钟。如果构造没有完成或报告过多的编译错误，则需要确认是否正确执行了以上的安装步骤。通过安装DDK和相应的开发软件，我们构造好了WDM驱动程序的开发环境。接着，我们就要深入进行设计与开发工作了。
　　安装DDK后，在DDK程序组下有检查Check和自由Free两个编译环境，Check环境用于编译带调试信息的驱动程序，Free则是编译正式发布版本的环境。通常情况下设备驱动程序的编译采用命令行的方式。通过一定的设置可以在vc++的集成环境下编译。
　　一般来说，成功编译一个最基本的设备驱动程序需要四个文件，第一个是驱动程序，即C语言源程序文件(例如isousb.c，注意下面所有的例子都是以isousb来说明)；第二个是RC文件(例如isousb.rc)；第三个是sourceS文件；第四个文件是MAKEFILE文件。SOURCES文件和make文件类似，用来指定需要编译的文件以及需要连接的库文件。这三个辅助文件都很简单，在DDK samples的每个例程里都有三个这样的文件，依样画瓢就能理解它们的结构和意义。
　　1.举例分析
　　以下以isousb程序为例，设isousb.rc代码为：
　　#include
　　#include
　　#define VER_FILETYPE VFT_DLL
　　#define VER_FILESUBTYPE VFT2_UNKNOWN
　　#define VER_FILEDESCRIPTION_STR "I82930 Isochronous IO Test Driver"
　　#define VER_INTERNALNAME_STR "IsoUsb.sys"
　　#define VER_ORIGINALFILENAME_STR "IsoUsb.sys"
　　#include "common.ver"
　　设备驱动程序一般都使用Build实用程序来进行，Build只是NMAKE外面的一个外包装程序。Build本身其实相当简单，编译的大部分工作实际上由Build传递给NMAKE来进行。
　　转自： http://www.99inf.net/SoftwareDev/VC/26476.htm