IoGetDeviceObjectPointer

从名字获得设备对象

在知道一个设备名字的情况下，使用函数IoGetDeviceObjectPointer可以获得这个设备对象的指针。这个函数的原型如下：

NTSTATUS IoGetDeviceObjectPointer( IN PUNICODE_STRING  ObjectName, IN ACCESS_MASK  DesiredAccess, OUT PFILE_OBJECT  *FileObject, OUT PDEVICE_OBJECT  *DeviceObject );

其中的ObjectName就是设备名字。DesiredAccess是期望访问的权限。实际使用时可以不要顾忌那么多，直接填写FILE_ALL_ACCESS即可。FileObject是一个返回参数，即获得这个设备对象的同时会得到的一个文件对象（File Object）。就打开串口设备这件事而言，这个文件对象并没有什么用处。但是必须注意：在使用这个函数之后必须把这个文件对象“解除引用”，否则会引起内存泄漏（请注意后面的代码）。

要得到的设备对象就返回在参数DeviceObject中了。示例如下：

#include <ntddk.h> // 因为用到了RtlStringCchPrintfW，所以必须使用头文件ntstrsafe.h // 这里定义NTSTRSAFE_LIB是为了使用静态的ntstrsafe静态库。这样才能 // 兼容Windows2000。 #define NTSTRSAFE_LIB #include <ntstrsafe.h> …… // 打开一个端口设备 PDEVICE_OBJECT ccpOpenCom(ULONG id,NTSTATUS *status) { // 外面输入的是串口的id，这里会改写成字符串的形式 UNICODE_STRING name_str; static WCHAR name[32] = { 0 }; PFILE_OBJECT fileobj = NULL; PDEVICE_OBJECT devobj = NULL;  // 根据id转换成串口的名字 memset(name,0,sizeof(WCHAR)*32); RtlStringCchPrintfW( name,32, L"\\Device\\Serial%d",id); RtlInitUnicodeString(&name_str,name);  // 打开设备对象 *status = IoGetDeviceObjectPointer( &name_str, FILE_ALL_ACCESS, &fileobj, &devobj); // 如果打开成功了，记得一定要把文件对象解除引用 // 总之，这一句不要忽视 if (*status == STATUS_SUCCESS) ObDereferenceObject(fileobj);  // 返回设备对象 return devobj; }