NT式驱动的基本结构 一

2024-01-26 15:28
文章标签 驱动 基本 结构 nt

本文主要是介绍NT式驱动的基本结构 一,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

        对于NT式驱动来说,主要的函数是 DriverEntry 例程、卸载例程及各个IRP的派例程。

        驱动加载过程与驱动入口函数(DriverEntry)和编写普通应用程序一样,驱动程序有个入口函数,也就是首先被执行的函数。这个函数通常被命名为DriverEntry,也可以指定另外的名字,但最好遵循这个名字。该函数的原型如下:

#pragma INITCODE 
extern "C" NTSTATUS DriverEntry(IN PDRIVER_OBJECT pDriverObject,
                                IN PUNICODE_STRING pRegistryPath)

        DriverEntry主要是对驱动程序进行初始化工作,它是由系统进程所调用的。在Windows中有个特殊的进程叫做系统进程,打开进程管理器,里面有个名为 System 的进程就是系统进程。系统进程在系统启动的时候,就已经被创建了。


        驱动加载的时候,系统进程启动新的线程,调用执行体组件中的对象管理器,创建一个驱动对象。这个驱动对象是一个 DRIVER_OBJECT 的结构体。另外,系统进程调用执行体组件中的配置管理程序,查询此驱动程序对应的注册表中的项。


        系统线程调用驱动程序的 DriverEntry 例程时,同时传进两个参数,分别是pDriverObject和pRegistryPath。其中,一个是指向刚才被创建驱动对象的指针,另外一个是指向设备服务键的键名字符串的指针。在 DriverEnty 中,主要功能是对系统进程创建的驱动对象进行初始化。另外,设备服务键的键名有时候需要保存下来,因为这个字符串不是长期存在的(函数返回后可能消失)。如果以后想使用这个UNICODE 字符串就必须先把它复制到安全的地方。


        这个字符串的内容一般是\REGISTRY\MACHINE\SYSTEM\ControlSet\lServices\[服务名]。在驱动程序中,字符串用UNICODE字符串来表示。UNICODE 是宽字符集,每个字符用16位表示。


其中,UNICODE用数据结构UNICODE_STRING表示:

typedef struct _UNICODE_STRING {
    USHORT Length;
    USHORT MaximumLength;
    PWCH   Buffer;
} UNICODE_STRING;


1. Length:记录这个字符串用多少字节记录。如果字符串有 N个字符,那么 Length将会是N的2倍。
2. MaximumLength:记录 buffer 的大小,也就是这个结构最大能记录的字节数,MaximumLength要大于或等于Length。
3. Buffer:记录字符串的指针。与ASCII字符串不同,这里的字符串每个字符都是16位。

在驱动中可以使用 KdPrint 打印UNICODE的信息。其语法是:
    KdPrint(("%S\n",pRegistryPath->Buffer));
    KdPrint(("%ws\n",pRegistryPath->Buffer));

        DriverEnty 返回值是NTSTATUS的数据,NTSTATUS是被定义为32位的无符号长整型。在驱动程序开发中,大家都习惯用NTSTATUS 返回状态。其中0-0X7FEFEEEEF,被认为是正确的状态,而 0X80000000-0XFFFFFFEF,被认为是错误的状态。有个非常有用的宏——NT_SUCCESS,被用来检测状态是否正确。

常用的NTSTATUS值有:

#define STATUS_SUCCESS				((NTSTATUS)0x00000000L)
#define STATUS_BUFFER_OVERFLOW		((NTSTATUS)0X80000005L)
#define STATTS UNSUCCESSFUL			((NTSTATUS)0Xc0000001L)
#define STATUS NOT_IMPLEMENTED		((NTSTATUS)0Xc0000002L)
#define STATUS_ACCESS_VIOLATION		((NTSTATUS)0Xc0000005L)
#define STATUS_INVALID_HANDLE		((NTSTATUS)0Xc0000008L)
#define STAT0S_INVALID_PARAMETE		((NTSTATUS)0Xc000000dL)


        DriverEinty 的返回值如果表示成功,则意味着加驱动成功,否则意味者加载驱动失败,调用对象管理程序销毁驱动对象。


        DriverEnrty 参数的修饰“IN”。“IN、“OUT”、“INOUT”在DDK中都被定义成空串,它们的功能类似于程序注释,当看到一个“IN”参数时,应该认定该参数是纯粹用于输入目的。“OUT”参数代表这个参数仅用于函数的输出参数。“INOUT用于既可以输入又可以输出的参数。例如 DriverEntry 例程,它的 DriverObjct 指针是IN参数,即使用者不能改变这个指针本身,但完全可以改变它指向的对象。

#pragma INITCODE 
extern "C" NTSTATUS DriverEntry(IN PDRIVER_OBJECT pDriverObject,IN PUNICODE_STRING pRegistryPath)
{NTSTATUS ntStatus = STATUS_SUCCESS;pDriverObject->DriverExtension->AddDevice           = XHB1509A_AddDevice;pDriverObject->MajorFunction[IRP_MJ_PNP]            = MJ_Pnp;pDriverObject->MajorFunction[IRP_MJ_DEVICE_CONTROL] = MJ_DispatchControlp;pDriverObject->MajorFunction[IRP_MJ_CREATE]         = MJ_Create;pDriverObject->MajorFunction[IRP_MJ_CLOSE]          = MJ_Close;pDriverObject->MajorFunction[IRP_MJ_READ]           = MJ_WriteRead;pDriverObject->MajorFunction[IRP_MJ_WRITE]          = MJ_WriteRead;pDriverObject->MajorFunction[IRP_MJ_POWER]          = MJ_Power;pDriverObject->MajorFunction[IRP_MJ_CLEANUP]        = MJ_CleanUp;pDriverObject->DriverUnload                         = MJ_Unload;return STATUS_SUCCESS;
}


        在 DrverEntry 函数中,一般设置卸载例程数和IRP的派函数,另外还有一部分代码负责创建设备对象。设置卸载例程和设置派遣函数都是对驱动对象的设置。设备对象中的MajorFunction 是一个函数指针数组,IRP_MJ_CREATE、IRP_MJ_CLOSE、IRP_MJ_WRITE 代表数组的第几个元素。

这篇关于NT式驱动的基本结构 一的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/647240

相关文章

基本知识点

1、c++的输入加上ios::sync_with_stdio(false);  等价于 c的输入,读取速度会加快(但是在字符串的题里面和容易出现问题) 2、lower_bound()和upper_bound() iterator lower_bound( const key_type &key ): 返回一个迭代器,指向键值>= key的第一个元素。 iterator upper_bou

usaco 1.3 Mixing Milk (结构体排序 qsort) and hdu 2020(sort)

到了这题学会了结构体排序 于是回去修改了 1.2 milking cows 的算法~ 结构体排序核心: 1.结构体定义 struct Milk{int price;int milks;}milk[5000]; 2.自定义的比较函数,若返回值为正,qsort 函数判定a>b ;为负,a<b;为0,a==b; int milkcmp(const void *va,c

【IPV6从入门到起飞】5-1 IPV6+Home Assistant(搭建基本环境)

【IPV6从入门到起飞】5-1 IPV6+Home Assistant #搭建基本环境 1 背景2 docker下载 hass3 创建容器4 浏览器访问 hass5 手机APP远程访问hass6 更多玩法 1 背景 既然电脑可以IPV6入站,手机流量可以访问IPV6网络的服务,为什么不在电脑搭建Home Assistant(hass),来控制你的设备呢?@智能家居 @万物互联

Linux_kernel驱动开发11

一、改回nfs方式挂载根文件系统         在产品将要上线之前,需要制作不同类型格式的根文件系统         在产品研发阶段,我们还是需要使用nfs的方式挂载根文件系统         优点:可以直接在上位机中修改文件系统内容,延长EMMC的寿命         【1】重启上位机nfs服务         sudo service nfs-kernel-server resta

自定义类型:结构体(续)

目录 一. 结构体的内存对齐 1.1 为什么存在内存对齐? 1.2 修改默认对齐数 二. 结构体传参 三. 结构体实现位段 一. 结构体的内存对齐 在前面的文章里我们已经讲过一部分的内存对齐的知识,并举出了两个例子,我们再举出两个例子继续说明: struct S3{double a;int b;char c;};int mian(){printf("%zd\n",s

C 语言的基本数据类型

C 语言的基本数据类型 注:本文面向 C 语言初学者,如果你是熟手,那就不用看了。 有人问我,char、short、int、long、float、double 等这些关键字到底是什么意思,如果说他们是数据类型的话,那么为啥有这么多数据类型呢? 如果写了一句: int a; 那么执行的时候在内存中会有什么变化呢? 橡皮泥大家都玩过吧,一般你买橡皮泥的时候,店家会赠送一些模板。 上

FreeRTOS-基本介绍和移植STM32

FreeRTOS-基本介绍和STM32移植 一、裸机开发和操作系统开发介绍二、任务调度和任务状态介绍2.1 任务调度2.1.1 抢占式调度2.1.2 时间片调度 2.2 任务状态 三、FreeRTOS源码和移植STM323.1 FreeRTOS源码3.2 FreeRTOS移植STM323.2.1 代码移植3.2.2 时钟中断配置 一、裸机开发和操作系统开发介绍 裸机:前后台系

OpenCV结构分析与形状描述符(11)椭圆拟合函数fitEllipse()的使用

操作系统:ubuntu22.04 OpenCV版本:OpenCV4.9 IDE:Visual Studio Code 编程语言:C++11 算法描述 围绕一组2D点拟合一个椭圆。 该函数计算出一个椭圆,该椭圆在最小二乘意义上最好地拟合一组2D点。它返回一个内切椭圆的旋转矩形。使用了由[90]描述的第一个算法。开发者应该注意,由于数据点靠近包含的 Mat 元素的边界,返回的椭圆/旋转矩形数据

Java 多线程的基本方式

Java 多线程的基本方式 基础实现两种方式: 通过实现Callable 接口方式(可得到返回值):

Java基础回顾系列-第一天-基本语法

基本语法 Java基础回顾系列-第一天-基本语法基础常识人机交互方式常用的DOS命令什么是计算机语言(编程语言) Java语言简介Java程序运行机制Java虚拟机(Java Virtual Machine)垃圾收集机制(Garbage Collection) Java语言的特点面向对象健壮性跨平台性 编写第一个Java程序什么是JDK, JRE下载及安装 JDK配置环境变量 pathHe