hello world,驱动对象与设备对象

whypro

这里所说的驱动对象是一种数据结构， 在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.当系统用到你的驱动，会向你的驱动发送IRP（这是
windows 所有驱动的共同工作方式）。你的任务是在dispatch function 中处理这些请求。你可以让irp 失败，也可以
成功返回，也可以修改这些irp，甚至可以自己发出irp。


设备对象则是指DEVICE_OBJECT.下边简称DO.
但是实际上每个irp
都是针对DO
发出的。只有针对由该驱动所生成的DO
的IRP, 才会发给该驱动来处理。具体的
分发函数，决定于DO
下的DriverObject
域。
当一个应用程序打开文件并读写文件的时候，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.那么E:,F:则是Fat
的两个Volume
设备对象.
实际上"C:"是该设备的符号连接（Symbolic Link）名。而不是真正的设备名。可以打开Symbolic Links Viewer,
能看到：
C:
\Device\HarddiskVolume1
因此该设备的设备名为“\Device\HarddiskVolume1”.
这里也看出来，文件系统驱动是针对每个Volume
来生成一个DeviceObject,而不是针对每个文件的。实际上对文
件的读写的irp,都发到Volume
设备对象上去了。并不会生成一个“文件设备对象”。
掌握了这些概念的话，我们现在用简单的代码来生成我们的CDO,作为我们开发文件系统驱动的第一步牛刀小试。


NTSTATUS
DriverEntry(
IN
PDRIVER_OBJECT
DriverObject,
IN
PUNICODE_STRING
RegistryPath
)
{
// 定义一个Unicode 字符串。
UNICODE_STRING
nameString;
RtlInitUnicodeString( &nameString, L"\\FileSystem\\Filters\\SFilter" );

// 生成控制设备
status =
IoCreateDevice( DriverObject,
0,
//has no device extension
&nameString,
FILE_DEVICE_DISK_FILE_SYSTEM,
FILE_DEVICE_SECURE_OPEN,
FALSE,
&gSFilterControlDeviceObject );

// 如果因为路径没找到而生成失败
if
(status ==
STATUS_OBJECT_PATH_NOT_FOUND) {
// 这是因为一些低版本的操作系统没有\FileSystem\Filters\这个目录

// 如果没有，我们则改变位置，生成到\FileSystem\下.
RtlInitUnicodeString( &nameString, L"\\FileSystem\\SFilterCDO" );

status =
IoCreateDevice( DriverObject,
0,&nameString,
FILE_DEVICE_DISK_FILE_SYSTEM,
FILE_DEVICE_SECURE_OPEN,
FALSE,
&gSFilterControlDeviceObject );

// 成功后，用KdPrint 打印一个log.
if
(!NT_SUCCESS( status )) {
KdPrint(( "SFilter!DriverEntry: Error creating control device object \"%wZ\",
status=%08x\n", &nameString, status ));
return
status;
}
}
else if
(!NT_SUCCESS(
status )) {
// 失败也打印一个。并直接返回错误
KdPrint(( "SFilter!DriverEntry: Error creating control device object \"%wZ\",
status=%08x\n", &nameString, status ));
}
return
status;
}
sfilter.sys.把这个文件与前所描述的inf 文件同一目录，按上节所叙述方法安装。
这个驱动不起任何作用，但是你已经成功的完成了"hello world".
初次看这些代码可能有一些慌乱。但是只要注意了以下几点，你就会变得轻松了:

1） 习惯使用UNICODE_STRING 字符串。这些字符串用Rtl…系列的函数来操作。你应该阅读DDK 帮助，然
后熟悉这些字符串的用法。
2） 用KdPrint(())来代替printf 输出信息。这些信息可以在DbgView 中看到。KdPrint(())自身是一个宏，
为了完整传入参数所以使用了两重括弧。这个比DbgPrint 调用要稍好。因为在free 版不被编译。
3） 查看DDK 帮助了解生成设备对象IoCreateDevice 的用法。
请注意CDO 生成后，保存在gSFilterControlDeviceObject 中。这样以后我们得到一个DEVICE_OBJECT 时，
就很容易判断是否是我们的控制设备。