在WDF的PCIe驱动程序中，共有四个.h文件（Public.h  Driver.h  Device.h  Trace.h）。本文将分别对四个文件源代码进行详细的解释。

Public.h

1 #ifndef _USER_H 2 #define _USER_H 3 // 4 // Define an Interface Guid so that app can find the device and talk to it. 5 // 6 #include <initguid.h> 7 // {49FA63A7-C525-4409-8DD5-EFF37A7375F8} 8 DEFINE_GUID(GUID_DEVINTERFACE_Spw_PCIe, 9 0x49fa63a7, 0xc525, 0x4409, 0x8d, 0xd5, 0xef, 0xf3, 0x7a, 0x73, 0x75, 0xf8); 10 #define Spw_PCIe_IOCTL_IN_BUFFERED CTL_CODE(FILE_DEVICE_UNKNOWN, 0x800, METHOD_BUFFERED, FILE_ANY_ACCESS)//the least value is 0x800 11 #define Spw_PCIe_IOCTL_OUT_BUFFERED CTL_CODE(FILE_DEVICE_UNKNOWN, 0x801, METHOD_BUFFERED, FILE_ANY_ACCESS) 12 #define Spw_PCIe_IOCTL_READ_PADDRESS CTL_CODE(FILE_DEVICE_UNKNOWN, 0x802, METHOD_BUFFERED, FILE_ANY_ACCESS) 13 #define Spw_PCIe_IOCTL_WRITE_OFFSETADDRESS CTL_CODE(FILE_DEVICE_UNKNOWN, 0x803, METHOD_BUFFERED, FILE_ANY_ACCESS) 14 #endif

代码文件名为Public，是因为这个文件要被驱动程序和应用程序共同使用的。在第4行的注释里，写明了本文件的主要作用是为驱动程序和应用程序的通信提供GUID接口。在Windows平台下实现对硬件设备的控制，需要应用程序能够与底层驱动进行通信，应用程序与驱动通信的设计过程中有两个重要的概念，即GUID值和CTL_CODE宏。

GUID（Globally Unique Identifier）是微软推出的全局唯一标识符，通过使用某个特定的算法（比如根据时间或地点等信息）生成一组128位二进制数，来标识某一个实体，比如硬盘上的一张图片。GUID广泛应用于微软的产品中，用于识别接口、文件等对象。开发者可以使用VS2013下的工具GUIDGen.exe生成GUID值，该GUID标识驱动程序，应用程序根据这个GUID值来找到对应的驱动程序。注意使用DEFINE_GUID宏，要包含initguid.h文件，否则会报出无法识别的error。

I/O处理例程DeviceIoControl（这个例程将在下一篇文章中详细介绍）的第二个参数dwIoControlCode就是由CTL_CODE宏定义的。CTL_CODE是一个用于创建一个唯一的32位系统I/O控制代码的宏，这个控制代码包括4部分组成：DeviceType（设备类型，高16位（16-31位）），Access（访问限制，14-15位），Function（功能2-13 位），Method（I/O访问内存使用方式）。CTL_CODE定义中有一个Method域，该域定义了驱动程序中获取应用程序数据缓冲区地址的方式。

10-13行代码为用户自定义的4个I/O控制命令，分别为读数据、写数据、读映射的BAR0的物理起始地址、写偏移地址(用来读写数据)。

第一个参数为设备类型，通常为自定义的板卡选择FILE_DEVICE_UNKNOWN；

注意，第二个数字要从0x800开始取值，之前的已经被微软占用；

第三个参数有四种选择（METHOD_BUFFERED、METHOD_IN_DIRECT、METHOD_OUT_DIRECT、METHOD_NEITHER），buffered方式：I/O管理器会创建与应用程序数据缓冲区完全相同的系统缓冲区，驱动程序在这个缓冲区工作，由I/O管理器完成复制数据任务；direct方式：I/O管理器锁定应用程序缓冲区的物理内存页，并创建一个MDL(内存描述符表)来描述该页，驱动程序将使用MDL工作；neither方式：I/O管理器把应用程序缓冲区的虚拟地址传递给驱动程序，一般不采用这种方式。

第四个参数用来设置文件读写权限，有三种选择（FILE_ANY_ACCESS、FILE_READ_ACCESS、FILE_WRITE_ACCESS），微软官方的说法是“The FILE_ACCESS_ANY is generally the correct value.”，所以我们还是老实的选用FILE_ACCESS吧。

Driver.h

1 #define INITGUID 2 #pragma warning(disable:4200) // 3 #pragma warning(disable:4201) // nameless struct/union 4 #pragma warning(disable:4214) // bit field types other than int 5 6 #include <ntddk.h> 7 #include <wdf.h> 8 9 #include "Public.h" 10 #include "device.h" 11 #include "trace.h"