设备对象(DEVICE_OBJECT)

WendyWJGu

已于 2024-01-26 13:04:55 修改

阅读量1k

点赞数 19

分类专栏： windows驱动开发文章标签： c++ 开发语言

于 2024-01-22 21:31:31 首次发布

本文链接：https://blog.csdn.net/wendyWJGU/article/details/135758773

版权

windows驱动开发专栏收录该内容

63 篇文章 1 订阅

订阅专栏

设备对象(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	声音输出设备对象