WDM驱动程序的框架.docxVIP

WDM驱动程序的框架1.??? DriverEntry ()DDK中定义的函数原型如下：NTSTATUS?DriverEntry (??IN?PDRIVER_OBJECT??DriverObject,??IN?PUNICODE_STRING??RegistryPath??);?DriverEntry的第一个参数是一个指针，指向一个刚被初始化的驱动程序对象，该对象就代表你的驱动程序。DriverEntry的第二个参数是设 备服务键的键名。如果该例程执行成功，则返回STATUS_SUCCESS，如果失败，则依据失败状态返回定义在ntstatus.h中的错误值。这是驱动程序的入口函数，相当于用户态程序的main()函数，它在驱动程序被加载进内存的时候调用。主要工作是把各种函数指针填入驱动程序对象。这些指 针为操作系统指明了驱动程序容器中各种子例程的位置，这样，该驱动程序对象关联的设备对象在接收到上层的IRP的时候，就会通过驱动程序对象中设置的函数 指针，找到相应的派遣函数来做处理。Eg.一个简单的DriverEntry（）代码片断：DriverObject-DriverUnload = DriverUnload;--1 DriverObject-DriverExtension-AddDevice = AddDevice; DriverObject-DriverStartIo = StartIo; DriverObject-MajorFunction [IRP_MJ_CREATE] = DriverDispatchCreate;--2 DriverObject-MajorFunction [IRP_MJ_CLOSE] = DriverDispatchClose;?DriverUnload 指向驱动程序的清除例程。I/O管理器会在卸载驱动程序前调用该例程。通常，WDM驱动程序的DriverEntry例程一般不分配任何资源，所以DriverUnload例程也没有什么清除工作要做。DriverDispatchxxx ?驱动程序可能仅需要处理几种类型的IRP，所以至少应该设置与那几种IRP类型相对应的指针元素，使它们指向相应的派遣函数。AddDevice ?指向驱动程序的AddDevice函数，在该函数中主要创建一个设备对象并把它连接到以pdo为底的设备堆栈中。2.??? AddDevice()DDK中定义的函数原型如下：NTSTATUS?XxxAddDevice (?IN?PDRIVER_OBJECT??DriverObject,?IN?PDEVICE_OBJECT??PhysicalDeviceObject??);AddDevice函数的第一个参数是指向该驱动的驱动对象的指针，第二个参数代表由底层驱动创建的物理设备对象。?对于功能驱动程序，其AddDevice函数的基本职责是创建一个设备对象并把它连接到以pdo为底的设备堆栈中。相关步骤如下：true 调用IoCreateDevice()创建设备对象，并建立一个私有的设备扩展对象。 true 寄存一个或多个设备接口，以便应用程序能知道设备的存在。另外，还可以给出设备名并创建符号连接。 true 初始化设备扩展和设备对象的Flag成员。 true 调用IoAttachDeviceToDeviceStack()函数把新设备对象放到堆栈上。 ?※关于AddDevice（）函数：在规范的WDM程序中，创建设备对象的任务本来该由AddDevice函数来做，而这个函数也是通过驱动程序对象的一 个函数指针来定位的。在这种规范的WDM程序中，一旦有新硬件加入，系统就会自动通过驱动程序对象的函数指针找到AddDevice函数，并调用它来创建 设备对象。但是在这里，并不是在为实际存在的硬件写驱动，而只是写一个内核模式下的程序，因此就只需要在DriverEntry函数中创建一个设备对象， 然后创建设备链接（可选）就可以了。（以上为网上摘录）?3.??? DriverDispatchXXX一般派遣函数有两个参数：一个指向mk:@MSITStore:D:/WINDDK/3790.1830/help/kmarch.chm::/hh/kmarch/k112_93734fb2-0dd1-4376-a595-44008eb68f2c.xml.htmDEVICE_OBJECT结构的指针，指向由驱动在AddDevice（或DriverEntry）中创建的设备对象。第二个参数是指向一个IRP结构的指针。?派遣函数DriverDispatchXXX主要负责处理上层的IRP。这里先要提一下，每个IRP都与两个数据结构相关联，就是IRP本身和IRP Stack——IO_STACK_LOCATION结构。在这两个结构里面，包含了所有上层