驱动名词解释.doc

驱动驱动 NTSTATUS NTSTATUS 是被定义为 32 位的无符号长整型。在驱动程序开发中, 人们习惯用 NTSTATUS 返回状态。其中 0~0X7FFFFFFF , 被认为是正确的状态,而 0X80000000~0XFFFFFFFF 被认为是错误的状态。有一个非常有用的宏-----ESS ,用来检测状态是否正确。 IN IN , OUT , INOUT 是一个空的宏,只是用来说明这个参数是用于输入参数,还是输出的参数。 DriverEntry 操作系统在初始化驱动程序的时候会调用 DriverEntry , 通常会用这个函数来填充 dispatch 例程的指针, 这就象注册回调函数一样。有的设备要创建设备的对象, 或者还要创建一个设备名字,以及其他的初始化操作。它的原型: NTSTATUS DriverEntry( IN PDRIVER_OBJECT DriverObject, IN PUNICODE_STRING RegistryPath ){} IN , OUT , INOUT 是一个空的宏,只是用来说明这个参数是用于输入参数,还是输出的参数。 NTSTATUS 实际是个长整型可以在 DDK 头文件 中找到 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(L"Hello"); KdPrint(("Buffer:%ws\nMaxinumLength:%d\nLength:%d", , , )); AddDevice AddDevice 例程是 WDM 特有的,在 DriverEntry 中需要设置 AddDevice 例程的函数地址