设备对象（DEVICE_OBJECT)

DEVICE_OBJECT结构体是操作系统用来表示某个具体的设备对象,一个设备对象是一个逻辑上的，或者虚拟的，或者物理上的设备的具体抽象，驱动通过设备对象来处理I/O请求。

[cpp]  view plain  copy

1. typedef struct _DEVICE_OBJECT {  
2.   CSHORT                      Type;  
3.   USHORT                      Size;  
4.   LONG                        ReferenceCount;  
5.   struct _DRIVER_OBJECT *  DriverObject;  
6.   struct _DEVICE_OBJECT *  NextDevice;  
7.   struct _DEVICE_OBJECT *  AttachedDevice;  
8.   struct _IRP *  CurrentIrp;  
9.   PIO_TIMER                   Timer;  
10.   ULONG                       Flags;  
11.   ULONG                       Characteristics;  
12.   __volatile PVPB             Vpb;  
13.   PVOID                       DeviceExtension;  
14.   DEVICE_TYPE                 DeviceType;  
15.   CCHAR                       StackSize;  
16.   union {  
17.     LIST_ENTRY         ListEntry;  
18.     WAIT_CONTEXT_BLOCK Wcb;  
19.   } Queue;  
20.   ULONG                       AlignmentRequirement;  
21.   KDEVICE_QUEUE               DeviceQueue;  
22.   KDPC                        Dpc;  
23.   ULONG                       ActiveThreadCount;  
24.   PSECURITY_DESCRIPTOR        SecurityDescriptor;  
25.   KEVENT                      DeviceLock;  
26.   USHORT                      SectorSize;  
27.   USHORT                      Spare1;  
28.   struct _DEVOBJ_EXTENSION  *  DeviceObjectExtension;  
29.   PVOID                       Reserved;  
30. } DEVICE_OBJECT, *PDEVICE_OBJECT;  

结构体成员：

Type 

操作系统用它来表明该对象是一个设备对象，对设备对象来说，该成员的值为3， 它是一个只读成员。

 

Size 

表明设备对象的size (字节为单位)，该字节不包括设备扩展对象（如果有的话）。它是一个只读成员。

 

ReferenceCount

I/O管理器用它来追踪与该设备对象相关联的设备被打开的句柄数量。这就使得I/O管理器可以避免当针对该驱动的设备的句柄在没有处理完的情况下卸载驱动的情况发生。它是一个只读成员。

 

DriverObject

驱动对象指针，表示一个已经加载的驱动的镜像，驱动对象将作为DriverEntry和AddDevice的输入参数之一，在调用IoCreateDevice 或者IoCreateDeviceSecure成功后，该成员由I/O管理器设置。 它是一个只读成员。

 

NextDevice

指向下一个由同一驱动程序创建的设备对象（如果有的话），在调用IoCreateDevice 或者 IoCreateDeviceSecure成功后，I/O管理器会自动更新设备列表。

对非即插即用（non –PnP）驱动来说，当驱动卸载时，必须层层穿越设备链表并删除设备，而对即插即用设备（PnP）来说则不需要如此，PnP驱动只需要在设备移除操作（IRP_MN_REMOVE_DEVICE）时进行相关的清理工作即可。

驱动重新创建设备对象时会自动用到该成员，它是一个可读可写的成员。

 

AttacheDevice

挂载设备指针，如果该设备对象没有挂载设备，则该成员为NULL，通过AttachedDevice成员指定的设备对象通常是过滤驱动程序的设备对象，过滤程序用于拦截那些针对该设备对象所代表的设备发起的I/O请求，该成员对外不可见。

 

CurrentIrp

当前IRP。

 

Timer

计时器指针，这使得I/O管理器可以间隔一秒钟调用驱动提供的及时器例程，详细可参考IoInitializeTimer。该成员可读可写。

 

Flags

值为如下：

DO_BUFFERED_IO 或者 DO_DIRECT_IO

DO_BUS_ENUMERATED_DEVICE

DO_DEVICE_INITIALIZING

DO_EXCLUSIVE

DO_MAP_IO_BUFFER

DO_POWER_INRUSH

DO_POWER_PAGABLE

DO_SHUTDOWN_REGISTERED

DO_VERIFY_VOLUME

 

Vpb

与该设备对象相关的卷参数块指针（VPB）。对系统文件驱动来说，VPB提供了一个连接没有命名的逻辑设备对象的功能，该逻辑设备对象代表着一个已挂载的卷。该成员是不可见的。

 

DeviceExtension

设备扩展结构指针，该结构体及其内容是由驱动定义的。大小也是由驱动决定的，该大小是在驱动调用IoCreateDevice或者IoCreatDeviceSecure函数是指定的。该成员是一个只读成员，但是，它指向的结构体式可以被驱动修改的。

 

DeviceType

由IoCreateDevice或者IoCreatDeviceSecure函数是设定，具体设定的参数是由历程中DeviceType参数决定的，详细参见设备种类描述表。

 

StackSize

指定发送给该驱动的IRP中stacklocation 的大小（最小值），IoCreateDevice和IoCreateDeviceSecure函数在新创建的设备对象中把该值设为1；最底层的驱动可以无视该成员。如果驱动调用IoAttachDevice 或者

IoAttachDeviceToDeviceStack函数时，I/O管理器在上层的驱动的设备对象中设置一个适当的值。

 

QueueAlignmentRequirement

该成员针对数据的传输时指定设备的地址对齐请求，该值必须是定义在Wdm.h中的形如FILE_XXX_ALIGNMENT的值中的一个。

 

DeviceQueue

设备对象的队列。驱动队列中包含了与驱动对象相应的等待驱动处理的IRP。

 

Dpc

延迟处理调用。

 

ActiveThreadCount

保留备用，该成员不可见。

 

SecurityDescriptor

当设备对象创建时指定安全描述表（SECURITY_DISCRIPTOR），如果该成员为空，则该设备对象当做默认的安全设定。虽然该成员可以通过ZwSetSecurityObject函数修改，但它是只读的。

 

DeviceLock

由I/O管理器创建的同步事件对象。

 

SectorSize

如果设备对象不是表示一个卷，该成员设成0，如果是表示一个卷，该成员表示的是卷的分区的字节数。

 

Spare1

保留供系统备用，该成员不可见。

 

DeviceObjectExtension

设备对象扩展指针，I/O管理器和PnP管理器用该对象来存储设备的一些状态信息，该成员不可见。

 

Reserved

保留供系统使用，该成员不可见。

 

备注：

操作系统通过设备对象来抽象具体设备。驱动程序通过IoCreateDevice和IoCreateDeviceSecure例程来创建设备对象。设备对象是半透明的。除了文中指出成员之外，驱动程序不应该直接设置驱动对象的成员。不可见成员是无法访问的。