Windows驱动开发(7) - DEVICE_OBJECT结构体

Windows驱动开发(7) - DEVICE_OBJECT结构体

typedef struct _DEVICE_OBJECT {
  CSHORT                    Type;
  USHORT                    Size;
  LONG                      ReferenceCount;
  struct _DRIVER_OBJECT *   DriverObject;
  struct _DEVICE_OBJECT *   NextDevice;
  struct _DEVICE_OBJECT *   AttachedDevice;
  struct _IRP *             CurrentIrp;
  PIO_TIMER                 Timer;
  ULONG                     Flags;
  ULONG                     Characteristics;
  __volatile PVPB           Vpb;
  PVOID                     DeviceExtension;
  DEVICE_TYPE               DeviceType;
  CCHAR                     StackSize;
  union {
    LIST_ENTRY           ListEntry;
    WAIT_CONTEXT_BLOCK   Wcb;
  } Queue;
  ULONG                     AlignmentRequirement;
  KDEVICE_QUEUE             DeviceQueue;
  KDPC                      Dpc;
  ULONG                     ActiveThreadCount;
  PSECURITY_DESCRIPTOR      SecurityDescriptor;
  KEVENT                    DeviceLock;
  USHORT                    SectorSize;
  USHORT                    Spare1;
  struct _DEVOBJ_EXTENSION* DeviceObjectExtension;
  PVOID                     Reserved;
} 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例程来创建设备对象。设备对象是半透明的。除了文中指出成员之外，驱动程序不应该直接设置驱动对象的成员。不可见成员是无法访问的