windows过滤中设备绑定的内核API之一

windows过滤中设备绑定的内核API之一

    进行过滤的最主要的方法是对一个设备对象（Device Object）进行绑定。读者可以想象，Windows系统之所以可以运作，是因为Windows中已经存在许多提供了各种功能的设备对象。这些设备对象接收请求，并完成实际硬件的功能。
    我们可以首先认为：一个真实的设备对应一个设备对象（虽然实际对应关系可能复杂得多）。通过编程可以生成一个虚拟的设备对象，并“绑定”（Attach）在一个真实的设备上。一旦绑定，则本来操作系统发送给真实设备的请求，就会首先发送到这个虚拟设备。
    下面结合代码进行讲解。读者可能希望编译执行这些代码，驱动的初学者请先阅读本书第1章，以便学会如何安装开发环境、编译代码和调试程序。
    在WDK中，有多个内核API能实现绑定功能。下面是其中一个函数的原型：
NTSTATUS
      IoAttachDevice(
        IN PDEVICE_OBJECT  SourceDevice,
        IN PUNICODE_STRING  TargetDevice,
        OUT PDEVICE_OBJECT  *AttachedDevice
      );
IoAttachDevice参数如下：
    SourceDevice是调用者生成的用来过滤的虚拟设备；而TargetDevice是要被绑定的目标设备。请注意这里的TargetDevice并 不是一个PDEVICE_OBJECT（DEVICE_OBJECT是设备对象的数据结构，以P开头的是其指针），而是一个字符串（在驱动开发中字符串用 UNICODE_STRING来表示）。实际上，这个字符串是要被绑定的设备的名字。
    Windows中许多设备对象是有名字的，但是并不是所有的设备对象都有名字。必须是有名字的设备，才能用这个内核API进行绑定。
    这里有一个疑问：假设这个函数绑定一个名字所对应的设备，那么如果这个设备已经被其他的设备绑定了，会怎么样呢？
    如果一个设备被其他设备绑定，它们在一起的一组设备，被称为设备栈（之所以称为栈，是由于和请求的传递方式有关）。实际上，IoAttachDevice总是会绑定设备栈上最顶层的那个设备。
    AttachedDevice是一个用来返回的指针的指针。绑定成功后，被绑定的设备指针被返回到这个地址。
    下面这个例子绑定串口1。之所以这里绑定很方便，是因为在Windows中，串口设备是有固定名字的。第一个串口名字为“\Device \Serial0”，第二个为“\Device\Serial1”，依次类推。请注意实际编码时C语言中的“\”要写成“\\”。
    UNICODE_STRING com_name = RLT_CONSTANT_STRING(L"\\Device\\Serial0");
    NTSTATUS status = IoAttachDevice(
    com_filter_device,        // 生成的过滤设备
    &com_device_name,        // 串口的设备名
    &attached_device);        // 被绑定的设备指针返回到这里
    当然，试图执行这段代码的读者可能会发现，这里没有提供如何生成一个过滤设备的代码。在接下来的第二个API介绍之后，读者会看到完整的例子。