驱动名词解释

驱动

NTSTATUS

NTSTATUS 是被定义为32位的无符号长整型。在驱动程序开发中，人们习惯用NTSTATUS 返回状态。其中0~0X7FFFFFFF，被认为是正确的状态，而0X80000000~0XFFFFFFFF被认为是错误的状态。

有一个非常有用的宏-----NT_SUCCESS，用来检测状态是否正确。

IN

IN，OUT，INOUT是一个空的宏，只是用来说明这个参数是用于输入参数，还是输出的参数。

DriverEntry

操作系统在初始化驱动程序的时候会调用DriverEntry，通常会用这个函数来填充dispatch例程的指针，这就象注册回调函数一样。有的设备要创建设备的对象，或者还要创建一个设备名字，以及其他的初始化操作。它的原型：

NTSTATUS DriverEntry(

IN PDRIVER_OBJECT DriverObject,

IN PUNICODE_STRING RegistryPath

){

}

IN，OUT，INOUT是一个空的宏，只是用来说明这个参数是用于输入参数，还是输出的参数。NTSTATUS实际是个长整型可以在DDK头文件NTSTA TUS.H中找到NTSTATUS的代码列表。函数的第一个参数DriverObject是刚被初始化的驱动对象，就是操作系统为这个驱动分配的空间的指针。函数的第二个参数RegistryPath是驱动在注册表中的键值。如果驱动程序需要访问设备的服务键需要保存这个键值以备后用。

UNICODE_STRING

UNICODE_STRING结构是通过使用各种本地安全认证（LSA）的功能来指定一个Unicode 字符串。

2结构体原型：

typedef struct _LSA_UNICODE_STRING {

USHORT Length;

USHORT MaximumLength;

PWSTR Buffer;} LSA_UNICODE_STRING, *PLSA_UNICODE_STRING, UNICODE_STRING, *PUNICODE_STRING;

3结构成员：

Length

指定字符串的长度，以字节为单位指出的Buffer字符串的长度。如果是以NULL字符结尾（即'\0'），则不包括NULL字符的长度。

MaximumLength

Buffer字符串的总长度。

MaximumLength和Length的关系可以参照：

char c[10] = "123";

sizeof(c);和strlen(c);得出的结果。

一个宽字符的字符串的指针。注意，通过各种LSA函数返回的字符串可能不是以NULL结尾。

4使用范例：

编辑

UNICODE_STRING str = RTL_CONSTANT_STRING(L"Hello");

KdPrint(("Buffer:%ws\nMaxinumLength:%d\nLength:%d", str.Buffer, str.MaximumLength, str.Length));

AddDevice

AddDevice例程是WDM特有的，在DriverEntry中需要设置AddDevice例程的函数地址。设置的方式是在驱动对象的DriverExtension子域的AddDevice子域保存AddDevice实际例程的函数地址。AddDevice例程的名字可以随意命名。

******************************************************************************* **************

NTSTAUS MyAddDevice(IN PDRIVER_OBJECT pDriverObject, IN PDEVICE_OBJECT PhysicalDeviceObject)

// 设置AddDevice实际例程的地址

pDriverObject->DriverExtension-> AddDevice = MyAddDevice;

#pragma code_set("INIT")

//将此函数放到INIT段中当驱动加载结束后，此函数就可以从内存中卸载掉

#pragma code_seg("PAGE")

//此例程分派在分页中保存

IRP_MJ_PNP

即插即用例程的一个基本操作，其完成操作系统即插即用管理器发出的即插即用信息，主要包括启动设备、停止设备、删除设备这三个功能，个别驱动还需要几个即插即用操作。

RtlInitUnicodeString

初始化字串

代码1：

UNICODE_STRING US1;

RtlInitUnicodeString(&US1,L"DDDD");

会动态分配一块指向“DDDD”的内存指针，赋值给US1.Buffer;

代码2：

wchar_t tmpstr[260]={0};

UNICODE_STRING US1;

RtlInitUnicodeString(&US1,tmpstr);

这时US1.Buffer直接指向tmpstr,如果修改了US1，也会同时修改tmpstr。

另外此时US1.MaximumLength=2;

要重新设定MaximumLength=260*2，才能正常使用。

IoCreateDevice()

IoCreateDevice函数用于创建常规的设备对象.

NTSTATUS IoCreateDevice

(

IN PDRIVER_OBJECT DriverObject,