[Windows驱动开发](三)基础知识——驱动例程
一、NT式驱动的基本例程
1. 驱动入口函数——DriverEntry
- // 驱动程序的一般性定义
- NTSTATUS DriverEntry(IN PDRIVER_OBJECT pDriverObject, IN PUNICODE_STRING pRegistryPath);
- //
DriverEntry的主要工作是对驱动程序进行初始化。它由系统进程System调用的。
驱动被加载的时候会创建一个驱动对象,查询此驱动程序对应的注册表项。
DriverEntry被调用的时候会传进两个参数。他们分别是刚才创建的驱动对象的指针和指向设备服务键的键名字符串指针。这个字符串的内容一般是\RESGISTRY\MACHINE\SYSTEM\ControlSet\Services\[服务名]。在驱动程序中,字符串一般以UNICODE形式存在:
注:设备服务键的键名有时候需要保存下来,当函数返回的时候此值可能会被清空。
DriverEntry等内核函数的返回值一般是NTSTATUS类型的。使用宏NT_SUCCESS(NTSTATUS status)可检测返回状态是否成功。
在DriverEntry中,一般需要做一下几件事情:
a. 设置驱动卸载例程
b. IRP的派发函数
c. 创建设备对象
其中,驱动卸载例程与IRP派发函数都是对驱动对象设置的。设备对象中有一个MajorFunction数字,用来存放哥哥IRP派发函数的函数指针。
在NT式驱动中,创建设备对象可以调用IoCreateDevice:
- // IoCreateDevice在WDK中的定义
- NTKERNELAPI
- NTSTATUS
- IoCreateDevice(
- __in PDRIVER_OBJECT DriverObject,
- __in ULONG DeviceExtensionSize,
- __in_opt PUNICODE_STRING DeviceName,
- __in DEVICE_TYPE DeviceType,
- __in ULONG DeviceCharacteristics,
- __in BOOLEAN Exclusive,
- __out
- __drv_out_deref(
- __drv_allocatesMem(Mem)
- __drv_when((((inFunctionClass$("DRIVER_INITIALIZE"))
- ||(inFunctionClass$("DRIVER_DISPATCH")))),
- __drv_aliasesMem)
- __on_failure(__null))
- PDEVICE_OBJECT *DeviceObject
- );
- //
DriverObject:当前驱动对象指针。
DeviceExtensionSize:设备扩展的大小。IO管理器会根据这个大小在内存中创建设备扩展,并与驱动对象关联。
DeviceName:设备对象的名称。
DeviceCharacteristics:设备对象的特征。
Exclusive:设备对象是否为内核模式下使用,一般固定为TRUE。
DeviceObject:创建好的设备对象指针。
注:设备名称字符串必须是\Device\[设备名]的形式。
让用户态的应用程序能识别设备一般有两种方法:
a. 符号链接
b. 设备接口(在NT式驱动很少使用)
符号链接可以理解为设备对象在用户态的名称。即:设备名称在内核态使用,符号链接在用户态使用。
创建符号链接可以使用IoCreateSymbolicLink:
- // IoCreateSymbolicLink在WDK中的定义
- NTKERNELAPI
- NTSTATUS
- IoCreateSymbolicLink(
- __in PUNICODE_STRING SymbolicLinkName,
- __in PUNICODE_STRING DeviceName
- );
- //
SymbolicLinkName:符号链接名。
DeviceName:设备对象名。
注:在内核态,符号链接是以“\??\”或者“\DosDevices\”开头的。而在用户模式下则是以“\\.\”开头的。
设备扩展在被使用时可使用如下的代码:
- // Code:使用设备扩展
- PDEVICE_EXTENSION pDeviceExtension = (PDEVICE_EXTENSION)pDeviceObject->DeviceExtension;
- //
2. 驱动卸载例程——DriverUnload
此例程在驱动卸载的时候被调用。在NT式驱动里面负责删除在DriverEntry中创建的设备对象,并且删除与其相关联的符号链接。同时还负责某些资源的回收工作。
删除设备对象的函数是IoDeleteDevice
- // IoDeleteDevice在WDK中的定义
- NTKERNELAPI
- VOID
- IoDeleteDevice(
- __in __drv_mustHold(Memory) __drv_freesMem(Mem) PDEVICE_OBJECT DeviceObject
- );
- //
DeviceObject:要被删除的设备对象指针。
删除符号链接的函数是IoDeleteSymbolicLink
- // IoDeleteSymbolicLink在WDK中的定义
- NTKERNELAPI
- NTSTATUS
- IoDeleteSymbolicLink(
- __in PUNICODE_STRING SymbolicLinkName
- );
- //
SymbolicLinkName:已经被注册的、待删除的符号链接。
根据驱动对象可以遍历所有由该驱动创建的设备对象。通过驱动对象的DeviceObject域可以找到驱动对象的第一个设备,然后根据设备对象的NextDevice域,就可以找到设备链表中其他的设备对象。
二、WDM式驱动的基本例程
//
在WDM模型中,一个设备的操作至少需要两个设备对象共同来完成。一个是物理设备对象(Physical Device Object,简称PDO),一个是功能设备对象(Function Device Object,简称FDO)。当计算机插入某个设备的时候,总线驱动会自动创建PDO。PDO不能单独操作设备,必须与FDO一起使用。当Windows提示要安装驱动的时候,实际上安装的是WDM驱动程序,负责创建FDO,并附加到PDO上。
当一个FDO附加在PDO的时候,PDO的AttachedDevice会记录FDO的位置。PDO是底层驱动(下层驱动),FDO是高层驱动(上层驱动)。
在FDO与PDO之间还会存在过滤驱动。在FDO上面的叫做上层过滤驱动,在FDO下层的叫做下层过滤驱动。一个WDM驱动可以有很多个上层过滤驱动和下层过滤驱动。设备对象的StackSize子域表明该设备对象到最下层的物理设备中间还存在的设备对象数。
1. WDM驱动的入口函数——DriverEntry
和NT式驱动一样,WDM驱动的入口程序也是DriverEntry。但是创建设备对象的功能并不在DriverEntry中执行,而是交给了新的例程——AddDevice;同时增加了对IRP_MJ_PNP处理的派发函数。
AddDevice例程是WDM特有的,在DriverEntry中需要设置AddDevice例程的函数地址。设置的方式是在驱动对象的DriverExtension子域的AddDevice子域保存AddDevice实际例程的函数地址。AddDevice例程的名字可以随意命名。
- // AddDevice函数声明
- NTSTAUS MyAddDevice(IN PDRIVER_OBJECT pDriverObject, IN PDEVICE_OBJECT PhysicalDeviceObject)
- // 设置AddDevice实际例程的地址
- pDriverObject->DriverExtension-> AddDevice = MyAddDevice;
- //
2. 驱动卸载例程——DriverUnload()
在WDM驱动中,实际的卸载工作被IRP_MN_REMOVE_DEVICE对应的派发函数处理了,这里的DriverUnload主要处理在DriverEntry中申请的内存。a. IRP_MN_REMOVE_DEVICE处理驱动横须内部是由IRP驱动的,IRP_MN_REMOVE_DEVICE这个IRP是当设备需要被卸载的时候,由即插即用管理器创建,并发送到驱动程序中的。IRP一般由两个号码指定该IRP的具体意义,一个是主IRP号(Major IRP),一个是辅IRP号(Minor IRP)。当设备需要被卸载的时候,会先后发出多个IRP_MJ_PNP。这些IRP的辅IRP号会有所不同。其中之一的IRP_MN_REMOVE_DEVICE。在WDM驱动程序中,对设备的卸载一般是在对IRP_MN_REMOVE_DEVICE的出口函数中进行卸载。其除了需要删除学部,取消符号链接外,还需要将FDO从PDO的堆栈中移除。需要调用IoDetachDevice:
- // IoDetachDevice在WDK中的定义:
- NTKERNELAPI
- VOID
- IoDetachDevice(
- __inout PDEVICE_OBJECT TargetDevice // 下层堆栈上的设备对象
- );
- //
此时,FDO从设备链上删除,但是PDO还在。PDO由操作系统负责删除。
AddDevice基本步骤:1. AddDevice通过IoCreateDevice函数创建FDO,创建FDO的符号链接2. 在驱动设备扩展保存刚才创建的FDO的地址。3. 调用IoAttachDeviceToDeviceStack()将FDO附加到PDO上。
- // IoAttachDeviceToDeviceStack在WDK中的定义
- NTKERNELAPI
- PDEVICE_OBJECT
- IoAttachDeviceToDeviceStack(
- __in __drv_mustHold(Memory) __drv_when(return!=0, __drv_aliasesMem)
- PDEVICE_OBJECT SourceDevice,
- __in PDEVICE_OBJECT TargetDevice
- );
- //
SourceDevice:FDO附加在PDO上时,这个参数代表FDO。TargetDevice:被附加的设备。如果在FDO与PDO之间存在过滤驱动,则FDO实际上是附加在过滤驱动上的,过滤驱动则附加在PDO上。返回值:返回SourceDevice的下层设备。
- // 根据上面的一个设备扩展定义
- typedef struct _DEVICE_EXTENSION
- {
- PDEVICE_OBJECT pFunctionDeviceObject; // 设备对象(FDO)
- UNICODE_STRING ustrDeviceName; // 设备名称
- UNICODE_STRING ustrSymbolicLinkName; // 符号链接名
- PDEVICE_OBJECT pNextStackDevice; // 下一个设备对象(FDO)的地址
- } DEVICE_EXTENSION, *PDEVICE_EXTENSION;
- //
4. 设置设备扩展pFunctionDeviceObject->Flags。DO_BUFFERED_IO:缓冲内存设备~DO_DEVICE_INITIALIZING:这个必须设置,表示完成Flags的初始化。
[Windows驱动开发](三)基础知识——驱动例程的更多相关文章
- Linux驱动开发1——基础知识
1.三类驱动 字符设备驱动:字节流,/dev下有设备节点,file_operations,inode, file 块设备驱动:数据块,/dev下有设备节点,通常有文件系统 网络设备驱动:网络报文的收发 ...
- 背水一战 Windows 10 (78) - 自定义控件: 基础知识, 依赖属性, 附加属性
[源码下载] 背水一战 Windows 10 (78) - 自定义控件: 基础知识, 依赖属性, 附加属性 作者:webabcd 介绍背水一战 Windows 10 之 控件(自定义控件) 自定义控件 ...
- android开发学习---基础知识学习、如何导入已有项目和开发一个电话拨号器
一.基础知识点学习 1.Android体系结构 如图所示,android 架构分为三层: (1)最底层是linux内核,主要是各种硬件的驱动,如相机驱动(Camera Driver),闪存驱动(Fl ...
- 【千纸诗书】—— PHP/MySQL二手书网站后台开发之基础知识
前言: 在具体回顾每一个功能的实现前,还是有必要先温习一些项目涉及到的PHP.MySQL[语法基础].项目github地址:https://github.com/66Web/php_book_stor ...
- ArcGIS API for JavaScript开发初探——基础知识
1.前言 在ArcGIS Web API开发体系中一共有四大类,分别为: ArcGIS API for Flex ArcGIS API for JavaScript ArcGIS API for RE ...
- Java开发培训基础知识解析之反射机制
Java是老牌编程语言,是当前应用最广泛的编程语言之一.想要学习Java你就一定要掌握Java基础知识,而反射对于初学Java的人来说绝对是非常重要的知识点.什么是反射?如何理解反射机制?如何使用反射 ...
- 单片机知识是Linux驱动开发的基础之一
这是arm裸机1期加强版第1课第2节课程的wiki文字版. 为什么没前途也要学习单片机? 因为它是个很好的入口. 学习单片机可以让我们抛开复杂的软件结构,先掌握硬件操作,如:看原理图.芯片手册.写程序 ...
- Spring注解驱动开发(三)-----自动装配
自动装配 概念 Spring利用依赖注入(DI),完成对IOC容器中中各个组件的依赖关系赋值. @Autowired-----自动注入 1.默认优先按照类型去容器中找对应的组件 application ...
- 【Unity3D游戏开发】基础知识之Tags和Layers (三二)[转]
Tags和Layers分别表示是Unity引擎里面的标签和层,他们都是用来对GameObject进行标识的属性,Tags常用于单个GameObject,Layers常用于一组的GameObject.添 ...
随机推荐
- Regulator IC forms convenient overvoltage detector
Figure 1 shows a simple, stand-alone overvoltage detector. The intent of the circuit is to monitor a ...
- 添加引用方式抛出和捕获干净的WebService异常
转载:http://www.cnblogs.com/ahdung/p/3953431.html 说明:[干净]指的是客户端在捕获WebService(下称WS)抛出的异常时,得到的ex.Message ...
- 使用Vue.js和Axios从第三方API获取数据 — SitePoint
更多的往往不是,建立你的JavaScript应用程序时,你会想把数据从远程源或消耗一个[ API ](https:/ /恩.维基百科.org /维基/ application_programming_ ...
- [Linux] git send-email的使用
1. git send-email is included in an individual package, named "git-email":$ sudo apt-get i ...
- Jni本地多线程回调Java函数,env->findClass()失败。
遇到的问题,Native层本地多线程回调Java函数时env->findClass()失败. 前面的代码是这样的在 JNI_OnLoad记录全局变量g_vm static JavaVM* g_v ...
- OpenERP|odoo Web开发
在OpenERP 7 和 Odoo 8下测试均可. 1.相关库/框架 主要:jQuery(使用1.8.3,如果使用新版本,其他jQuery插件也要升级或修改).Underscore.Qweb 其他:都 ...
- Ubuntu 12.04 LTS安装Windows字体
内容参考自别人的博客:http://www.cnblogs.com/zhj5chengfeng/p/3251009.html 1. 为了方便,先将Windows字体拷贝到~/WinFonts下. 我是 ...
- go语言基础之运算符
一.运算符分类 1.1 算术运算符 运算符 术语 示例 结果 + 加 10 + 5 15 - 减 10 - 5 5 * 乘 10 * 5 50 / 除 10 / 5 2 % 取模(取余) 10 % 3 ...
- java.lang.IllegalArgumentException:Document base ……does not exist or is not a readable directory错误的解决方案
关于Tomcat的 Document base ……does not exist or is not a readable directory错误 java.lang.IllegalArgumentE ...
- myBatis + SpringMVC上传、下载文件
摘自: http://limingnihao.iteye.com/blog/1069503 环境:maven+SpringMVC + Spring + MyBatis + MySql 本文主要说明如何 ...