设备对象(DEVICE_OBJECT)

        设备对象(DEVICE_OBJECT)
        每个驱动程序会创建一个或多个设备对象,用DEVICE_OBJECT数据结构表示。每个设备对象都会有一个指针指向下一个设备对象,因此就形成一个设备链。设备对象链的第一个设备是由DRIVER_OBJECT结构体中指明的。设备对象保存设备特征和状态的信息,其数据结构定义如下:

typedef struct _DEVICE_OBJECT {
  CSHORT                   Type;			// 由操作系统用来指示对象是设备对象。 对于设备对象,此成员的值为 3。 这是一个只读成员
 
  USHORT                   Size;			// 指定设备对象的大小(以字节为单位)。 此大小包括 DeviceExtension
											// 成员指向的驱动程序指定的设备扩展,但不包括 DeviceObjectExtension 
										    // 成员指向的不透明设备对象扩展。 Size 是只读成员。
  
  LONG                     ReferenceCount;	// 由 I/O 管理器用于跟踪与设备对象关联的设备的打开句柄数。 
											// 这样,当驱动程序的设备 () 有未完成的句柄时,
											// I/O 管理器就可以避免卸载驱动程序。 这是一个只读成员。
											
  struct _DRIVER_OBJECT    *DriverObject;	// DriverObject: 指向驱动程序中的驱动对象。
											// 同属于一个驱动程序的驱动对象指向的是统一驱动对象。
  
  struct _DEVICE_OBJECT    *NextDevice;		// NextDevice:指向下一个设备对象。这里指的下一个设备对象是同属于一个驱动对象的设备,
											// 也就是同一个驱动, 程序创建的若干设备对象。每个设备对象根据NextDevice域形成链表,
											// 从而可以枚举每个设备对象。


  struct _DEVICE_OBJECT    *AttachedDevice;	// AttachedDevice: 指向下一个设备对象。这里指的出,如果由更高一层的驱动附加
											// 到这个驱动的时候,AttachedDevice 指向的就是那个更高一层的驱动。

  struct _IRP              *CurrentIrp;		// CurrentIrp: 在使用StartIO例程的时候,此域指向的是当前IRP结构。
  
  PIO_TIMER                Timer;			// 指向计时器对象的指针。 这允许 I/O 管理器每秒调用驱动程序提供的计时器例程。
											// 有关详细信息,请参阅 IoInitializeTimer。 这是一个读/写成员
  
  ULONG                    Flags;			// Flags: 此域是一个32位的无符号整形。每一个位由具体的含义。
  ULONG                    Characteristics;
  __volatile PVPB          Vpb;
  PVOID                    DeviceExtension;	// DeviceExtension : 指向的是设备的扩展对象。每个设备都会指定一个设备扩展对象。
											// 设备扩展对象记录的是设备自己特殊定义的结构体,也就是由程序员自己定义的结构体。
											// 另外,在驱动程序中,应该尽量避免全局变量的使用,因为全局变量涉及不容易同步的问
											// 题。解决的办法,将全局变量存在设备扩展里。
  
  DEVICE_TYPE              DeviceType;		// DeviceType: 指明设备的类型,常用类型如下
  
  CCHAR                    StackSize;
  union {
    LIST_ENTRY         ListEntry;
    WAIT_CONTEXT_BLOCK Wcb;
  } Queue;
  ULONG                    AlignmentRequirement; // AlignmentRequirement: 设备在大容量传输的时候需要
									             // 内存对其,以保证传输速度。
  
  KDEVICE_QUEUE            DeviceQueue;
  KDPC                     Dpc;
  ULONG                    ActiveThreadCount;
  PSECURITY_DESCRIPTOR     SecurityDescriptor;
  KEVENT                   DeviceLock;
  USHORT                   SectorSize; // StackSize: 在多层驱动的情况下,驱动与驱动之间会形成类似
									   // 堆栈的结构。IRP会依次从最高层传递到最底层。
									   // StackSize描述的就是这个层次
									   
  USHORT                   Spare1;
  struct _DEVOBJ_EXTENSION *DeviceObjectExtension;
  PVOID                    Reserved;
} DEVICE_OBJECT, *PDEVICE_OBJECT;

        根据设备需要,需要填写相应的设备类型。当制作虚拟设备时,应选择FILE_DEVICE_UNKNOWN类型的设备。

表2 DeviceType
设备类型 编码 描述
FILE_DEVICE_8042_PORT           0x00000027 8042端口设备对象
FILE_DEVICE_ACPI                0x00000032 ACPI设备对象
FILE_DEVICE_BATTERY             0x00000029 电池设备对象
FILE_DEVICE_BEEP                0x00000001 蜂鸣器设备对象
FILE_DEVICE_BUS_EXTENDER        0x0000002a 总线扩展设备对象
FILE_DEVICE_CD_ROM              0x00000002 CD光驱设备对象
FILE_DEVICE_CD_ROM_FILE_SYSTEM  0x00000003 CD光驱文件系统设备对象
FILE_DEVICE_CHANGER             0x00000030 充电设备对象
FILE_DEVICE_CONTROLLER          0x00000004 控制器设备对象
FILE_DEVICE_DATALINK            0x00000005 数据链设备对象
FILE_DEVICE_DFS                 0x00000006 DFS设备对象
FILE_DEVICE_DFS_FILE_SYSTEM     0x00000035  
FILE_DEVICE_DFS_VOLUME          0x00000036  
FILE_DEVICE_DISK                0x00000007 磁盘设备对象
FILE_DEVICE_DISK_FILE_SYSTEM    0x00000008 磁盘文件系统设备对象
FILE_DEVICE_DVD                 0x00000033 DVD设备对象
FILE_DEVICE_FILE_SYSTEM         0x00000009 文件系统设备对象
FILE_DEVICE_FIPS                0x0000003a  
FILE_DEVICE_FULLSCREEN_VIDEO    0x00000034  
FILE_DEVICE_INPORT_PORT         0x0000000a 输入端口设备对象
FILE_DEVICE_KEYBOARD            0x0000000b 磁盘设备对象
FILE_DEVICE_KS                  0x0000002f 内核流设备对象
FILE_DEVICE_KSEC                0x00000039  
FILE_DEVICE_MAILSLOT            0x0000000c 邮件槽设备对象
FILE_DEVICE_MASS_STORAGE        0x0000002d 大容量存储设备对象
FILE_DEVICE_MIDI_IN             0x0000000d MIDI输入设备对象
FILE_DEVICE_MIDI_OUT            0x0000000e MIDI输出设备对象
FILE_DEVICE_MODEM               0x0000002b 调制解调器设备对象
FILE_DEVICE_MOUSE               0x0000000f 鼠标设备对象
FILE_DEVICE_MULTI_UNC_PROVIDER  0x00000010 多UNC设备对象
FILE_DEVICE_NAMED_PIPE          0x00000011 命名管道设备对象
FILE_DEVICE_NETWORK             0x00000012 网络设备对象
FILE_DEVICE_NETWORK_BROWSER     0x00000013 网络浏览器设备对象
FILE_DEVICE_NETWORK_FILE_SYSTEM 0x00000014 网络文件系统设备对象
FILE_DEVICE_NETWORK_REDIRECTOR  0x00000028 网卡设备对象
FILE_DEVICE_NULL                0x00000015 空设备对象
FILE_DEVICE_PARALLEL_PORT       0x00000016 并口设备对象
FILE_DEVICE_PHYSICAL_NETCARD    0x00000017 物理网卡设备对象
FILE_DEVICE_PRINTER             0x00000018 打印机设备对象
FILE_DEVICE_SCANNER             0x00000019 扫描仪设备对象
FILE_DEVICE_SCREEN              0x0000001c 屏幕设备对象
FILE_DEVICE_SERENUM             0x00000037  
FILE_DEVICE_SERIAL_MOUSE_PORT   0x0000001a 串口鼠标设备对象
FILE_DEVICE_SERIAL_PORT         0x0000001b 串口设备对象
FILE_DEVICE_SMARTCARD           0x00000031 智能卡设备对象
FILE_DEVICE_SMB                 0x0000002e SMB设备对象
FILE_DEVICE_SOUND               0x0000001d 声音设备对象
FILE_DEVICE_STREAMS             0x0000001e 流设备对象
FILE_DEVICE_TAPE                0x0000001f 磁带设备对象
FILE_DEVICE_TAPE_FILE_SYSTEM    0x00000020 磁带文件系统设备对象
FILE_DEVICE_TERMSRV             0x00000038  
FILE_DEVICE_TRANSPORT           0x00000021 传输设备对象
FILE_DEVICE_UNKNOWN             0x00000022 未知设备对象
FILE_DEVICE_VDM                 0x0000002c  
FILE_DEVICE_VIDEO               0x00000023 视频设备对象
FILE_DEVICE_VIRTUAL_DISK        0x00000024 虚拟磁盘设备对象
FILE_DEVICE_WAVE_IN             0x00000025 声音输入设备对象
FILE_DEVICE_WAVE_OUT            0x00000026 声音输出设备对象