02.Windows文件系统过滤驱动开发教程(2)

Windows文件系统过滤驱动开发教程2.hello world,驱动对象与设备对象这里所说的驱动对象是一种数据结构，在DDK中名为DRIVER_OBJECT。

任何驱动程序都对应一个DRIVER_OBJECT.如何获得本人所写的驱动对应的DRIVER_OBJECT呢？驱动程序的入口函数为DriverEntry,因此，当你写一个驱动的开始，你会写下如下的代码：NTSTATUS DriverEntry(IN PDRIVER_OBJECT DriverObject, IN PUNICODE_STRING RegistryPath ){}这个函数就相当与喜欢c语言的你所常用的main().IN是无意义的宏，仅仅表明后边的参数是一种输入，而对应的OUT则代表这个参数是一种返回。

这里没有使用引用,因此如果想在参数中返回结果，一律传入指针。

DriverObject就是你所写的驱动对应的DRIVER_OBJECT,是系统在加载你的驱动时候所分配的。

RegisteryPath是专用于你记录你的驱动相关参数的注册表路径。

DriverObject重要之处，在于它拥有一组函数指针，称为dispatch functions.开发驱动的主要任务就是亲手撰写这些dispatch functions.当系统用到你的驱动，会向你的DO发送IRP（这是windows所有驱动的共同工作方式）。

你的任务是在dispatch function中处理这些请求。

你可以让irp失败，也可以成功返回，也可以修改这些irp，甚至可以自己发出irp。

设备对象则是指DEVICE_OBJECT.下边简称DO.但是实际上每个irp都是针对DO发出的。

只有针对由该驱动所生成的DO的IRP, 才会发给该驱动来处理。

当一个应用程序打开文件并读写文件的时候，windows系统将这些请求变成irp发送给文件系统驱动。

文件系统过滤驱动将可以过滤这些irp.这样，你就拥有了捕获和改变文件系统操作的能力。

象Fat32,NTFS这样的文件系统(File System,简称FS)，可能生成好几种设备。

首先文件系统驱动本身往往生成一个控制设备（CDO）.这个设备的主要任务是修改整个驱动的内部配置。

因此一个Driver只对应一个CDO.另一种设备是被这个文件系统Mount的Volume。

一个FS可能有多个Volume,也可能一个都没有。

解释一下，如果你有C:,D:,E:,F:四个分区。

C:,D:为NTFS,E:,F:为Fat32.那么C:,D:则是Fat的两个Volume设备对象.实际上"C:"是该设备的符号连接（Symbolic Link）名。

而不是真正的设备名。

可以打开Symbolic Links Viewer,能看到：C: DeviceHarddiskVolume1因此该设备的设备名为“DeviceHarddiskVolume1”.这里也看出来，文件系统驱动是针对每个Volume来生成一个DeviceObject,而不是针对每个文件的。

实际上对文件的读写的irp,都发到Volume设备对象上去了。

并不会生成一个“文件设备对象”。

掌握了这些概念的话，我们现在用简单的代码来生成我们的CDO,作为我们开发文件系统驱动的第一步牛刀小试。

我不喜欢用微软风格的代码。

太长而且难看。

我对大部分数据结构和函数进行了重定义。

为此我写了一个名为wdf.h的头文件帮助我转换。

有兴趣的读者可以发邮件向索取这个文件。

没有也没有关系，我总是会写出wd_xxx系列的东西在DDK中的原形。

// -----------------wdf_filter.c中的内容-------------------------#include "wdf.h"wd_stat wdff_cdo_create(in wd_drv *driver, in wd_size exten_len,in wd_ustr *name, out wd_dev **device){return wd_dev_create(driver, exten_len, name, wd_dev_disk_fs,wdf_dev_secure_open, wd_false, device);}wd_stat wd_main(in wd_drv* driver, in wd_ustr* reg_path){wd_ustr name;wd_stat status = wd_stat_suc;// 然后我生成控制设备,虽然现在我的控制设备什么都不干wd_ustr_init(&name,L"\FileSystem\Filters\our_fs_filter");status = wdff_cdo_create(driver,0,&name,&g_cdo);if(!wd_suc(status)){if(status == wd_stat_path_not_found){// 这种情况发生于FileSystemFilters路径不存在。

这个路径是// 在xp上才加上的。

所以2000下会运行到这里wd_ustr_init(&name,L"\FileSystem\our_fs_filter");status = wdff_cdo_create(driver,0,&name,&g_cdo);};if(!wd_suc(status)){wd_printf0("error: create cdo failed.rn");return status;}}wd_printf0("success: create cdo ok.rn");return status;}为了让代码看起来象上边的那样，我不得不做了很多转换。

如#define DriverEntry wd_main一种爽的感觉，终于可以在写看起来更象是main()的函数中工作了。

wd_dev_create 这个函数内部调用的是IoCreateDevice.而wd_suc实际上是SUCCESS()这样的宏。

// ----------------------wdf.h中的内容------------------------------#include "ntifs.h"#define in IN#define out OUT#define optional OPTIONAL#define wd_ustr UNICODE_STRING#define wdp_ustr PUNICODE_STRING#define wd_main DriverEntry// 设备、驱动对象类型typedef DRIVER_OBJECT wd_drv;typedef DEVICE_OBJECT wd_dev;typedef PDRIVER_OBJECT wd_pdrv;typedef PDEVICE_OBJECT wd_pdev;enum {wd_dev_disk_fs = FILE_DEVICE_DISK_FILE_SYSTEM,wd_dev_cdrom_fs = FILE_DEVICE_CD_ROM_FILE_SYSTEM,wd_dev_network_fs = FILE_DEVICE_NETWORK_FILE_SYSTEM};// 状态相关的类型和宏typedef NTSTATUS wd_stat;enum {wd_stat_suc = STATUS_SUCCESS,wd_stat_path_not_found = STATUS_OBJECT_PATH_NOT_FOUND,wd_stat_insufficient_res = STATUS_INSUFFICIENT_RESOURCES,wd_stat_invalid_dev_req = STATUS_INVALID_DEVICE_REQUEST,wd_stat_no_such_dev = STATUS_NO_SUCH_DEVICE,wd_stat_image_already_loaded = STATUS_IMAGE_ALREADY_LOADED, wd_stat_more_processing = STATUS_MORE_PROCESSING_REQUIRED, wd_stat_pending = STATUS_PENDING};（inline的使用是有所限制的，inline 函数一般必须在头文件内，inline只适合函数体内代码简单的函数使用，不能包含复杂的结构控制语句例如while switch，并且不能内联函数本身不能是直接递归函数(自己内部还调用自己的函数)。

）_inline wd_bool wd_suc(wd_stat state) //内聯函數{return NT_SUCCESS(state);}#define wd_printf0 DbgPrint_inline wd_void wd_ustr_init(in out wd_ustr* str,in const wd_wchar* chars){RtlInitUnicodeString(str,chars);};_inline wd_void wd_ustr_init_em(in out wd_ustr *str ,in wd_wchar *chars,in wd_size size){RtlInitEmptyUnicodeString(str,chars,size);};wdf.h这个文件我仅仅节选了需要的部分。

以上您已经拥有了一个简单的“驱动”的完整的代码。

它甚至可以编译，安装（请修改sfilter.inf文件，其方法不过是将多处sfilter 改为"our_fs_filter",希望这个过程中您不会出现问题）。

然后把wdf.h和wdf_filter.c 放在您新建立的目录下，这个目录下还应该有另两个文件。

一个是Makefile,请从sfilter目录下拷贝。

另一个是SOURCES，请输入如下内容：TARGETNAME=our_fs_filterTARGETPATH=objTARGETTYPE=DRIVERDRIVERTYPE=FSBROWSER_INFO=1SOURCES=wdf_filter.c使用DDK编译之后您将得到our_fs_filter.sys.把这个文件与前所描述的inf 文件同一目录，按上节所叙述方法安装。

这个驱动不起任何作用，但是你已经成功的完成了"hello world".。