驱动名词解释.docVIP

驱动 驱动 NTSTATUS NTSTATUS 是被定义为32位的无符号长整型。在驱动程序开发中，人们习惯用 NTSTATUS 返回状态。其中0~0X7FFFFFFF，被认为是正确的状态，而00XFFFFFFFF被认为是错误的状态。 有一个非常有用的宏NT_SUCCESS，用来检测状态是否正确。 IN IN，OUT，INOUT是一个空的宏，只是用来说明这个参数是用于输入参数，还是输出的参数。 DriverEntry 操作系统在初始化驱动程序的时候会调用DriverEntry，通常会用这个函数来填充dispatch例程的指针，这就象注册回调函数一样。有的设备要创建设备的对象，或者还要创建一个设备名字，以及其他的初始化操作。它的原型： NTSTATUS DriverEntry( IN PDRIVER_OBJECT DriverObject, IN PUNICODE_STRING RegistryPath ){ } IN，OUT，INOUT是一个空的宏，只是用来说明这个参数是用于输入参数，还是输出的参数。NTSTATUS实际是个长整型可以在DDK头文件NTSTATUS.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);得出的结果。 Buffer 一个宽字符的字符串的指针。注意，通过各种LSA函数返回的字符串可能不是以NULL结尾。 4使用范例： 编辑 UNICODE_STRING str = RTL_CONSTANT_STRING(LHello); 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 即插即用例程的一个基本操作，其完成操作系统即插即用管理器发出的即插即用信息，主要包括启动设备、停止设备、删除设备这三个功能，个