Windows中Filter-Hook驱动程序

Windows中Filter-Hook驱动程序

在Windows 2000和Windows XP中，System32/drivers目录下的ipfltdrv.sys是Microsoft提供的ip协议过滤驱动程序。它允许用户注册自己的ip数据报处理函数。在MSDN中有关于这方面内容的简短说明，位于Filter-Hook Driver Reference章节中。这一部分说明文档论述了filter-hook驱程实现的回调函数和该驱程用以注册回调函数的I/O控制码。回调函数是这类驱程的主体部分。操作系统提供的ip过滤驱动程序使用这个过滤钩子来判断ip数据包的处理方式。

所注册的过滤钩子是用PacketFilterExtensionPtr数据类型定义的。由于是使用函数的地址而不是函数的名字注册过滤钩子的入口点，所以可以自由的为过滤钩子函数命名。下面分别说明钩子的数据结构和注册该钩子的I/O控制码。

PacketFilterExtensionPtr

下面是他的定义。

typedef PF_FORWARD_ACTION (*PacketFilterExtensionPtr)(

                              unsigned char   *PacketHeader,

                              unsigned char   *Packet,

                              unsigned int    PacketLength,

                              unsigned int    RecvInterfaceIndex,

                              unsigned int    SendInterfaceIndex,

                              IPAddr          RecvLinkNextHop,

                              IPAddr          SendLinkNextHop

                              );

 

该类型就是过滤钩子的回调函数，他决定所有传过来的ip数据包的命运，是继续传递，还是丢掉，或者允许ip过滤驱动程序继续处理。

1.         参数

PacketHeader

指向该数据包的ip头部的指针。Filter-Hook驱动程序可以将其转换为IPHeader结构指针类型。

Packet

Filter-Hook驱动程序接收到的包含数据包信息的缓冲区指针。该缓冲区不包含PacketHeader指针指向的ip协议头。

PacketLength

以字节为单位的Packet缓冲区的长度。该长度不包含ip协议头的大小。

RecvInterfaceIndex

数据包到达的接口适配器的序号。Filter-Hook驱动程序使用该序号访问接收数据包的适配器。

对于发送的数据包，该参数为INVALID_PF_IF_INDEX，并且参数RecvLinkNextHop的值没有意义。

SendInterfaceIndex

数据包发送的接口适配器的序号。如果数据包需要通过该适配器路由，可以通过简单网络协议（SNMP）查询路由表。

对于接收的数据包，该参数为INVALID_PF_IF_INDEX，并且参数SendLinkNextHop的值没有意义。

RecvLinkNextHop

如果接口适配器是一个多点（绑定多个ip地址？）接口，该参数为适配器接收该数据包时的ip地址。否则，该参数为ZERO_PF_IP_ADDR。

SendLinkNextHop

如果接口适配器是一个多点（绑定多个ip地址？）接口，该参数为适配器接发送数据包时的ip地址。否则，该参数为ZERO_PF_IP_ADDR。

2.         返回值

返回PF_FORWARD_ACTION枚举类型的值：

PF_FORWARD

该返回值指示ip过滤驱动程序应该立刻将数据包转发到ip协议栈中。如果该数据包是本机需要的数据包，ip协议将其转发给上层协议处理，如果不是到本机的数据包，则ip将路由该数据包（如果此时路由功能被打开）。

PF_DROP

该返回值指示ip过滤驱动程序将立刻向ip协议栈发出丢弃响应。这时ip协议将丢弃该数据包。

PF_PASS

该返回值指示ip过滤驱动程序处理该数据包，并将结果动作返回到ip协议栈。如果Filter-Hook驱动程序认为不需要处理该数据包，则应该返回该值。

3.         注释

如果Filter-Hook驱动程序返回PF_PASS，ip过滤驱动程序将处理该数据包。在这种情况下，用户态应用程序可以通过Packet Filtering API控制包的过滤动作（iphlpapi.lib）。通过这些API函数可以创建和管理ip数据包的输入输出。每一个ip适配器接口都可以有一个或几个与其相关联的过滤器。过滤器可以包括ip地址，地址掩码，端口号，协议标示符。更多的信息参考Platform SDK。

IP过滤驱动程序可以使用IPHeader结构传递数据包的ip头信息。

4.         IPHeader

PacketHeader参数指向的缓冲区通常被定义为IPHeader结构。该结构提供了数据包的细节信息。其定义如下：

typedef struct iphdr {

    UCHAR     iph_verlen;     // Version and length

    UCHAR     iph_tos;        // Type of service

    USHORT    iph_length;     // Total datagram length

    USHORT    iph_id;         // Identification

    USHORT    iph_offset;     // Flags, fragment offset

    UCHAR     iph_ttl;        // Time to live

    UCHAR     iph_protocol;   // Protocol

    USHORT    iph_xsum;       // Header checksum

    ULONG     iph_src;        // Source address

    ULONG     iph_dest;       // Destination address

} iphdr;

 

该结构的成员的含义参看其后面的注释。在Linux源程序中或者其他讲解TCP/IP协议的书籍中都有详细的说明。

IOCTL_PF_SET_EXTENSION_POINTER

Filter-Hook使用该I/O控制码建立一个IRP，并将其提交给ip过滤驱动程序。通常filter-hook驱动程序使用IoBuildDeviceIoControlRequest函数建立所需的IRP。

该控制码向ip过滤驱动程序注册过滤钩子回调函数，当有数据包发送或者接收时，ip过滤驱动程序就要调用这些回调函数。并且，该控制码也用来从ip过滤驱动程序中清除回调函数。

为了方便对比，给出在IoBuildDeviceIoControlRequest函数的原型：

PIRP IoBuildDeviceIoControlRequest(

    IN ULONG IoControlCode,

    IN PDEVICE_OBJECT DeviceObject,

    IN PVOID InputBuffer OPTIONAL,

    IN ULONG InputBufferLength,

   OUT PVOID OutputBuffer OPTIONAL,

    IN ULONG OutputBufferLength,

    IN BOOLEAN InternalDeviceIoControl,

    IN PKEVENT Event,

    OUT PIO_STATUS_BLOCK IoStatusBlock

    );

在这里，使用IoBuildDeviceIoControlRequest函数时，其参数如下：

pIrp=IoBuildDeviceIoControlRequest(

        IOCTL_PF_SET_EXTENSION_POINTER,

        pTargetDeviceObject,

        &HookInfo,sizeof(PF_SET_EXTENSION_HOOK_INFO),

        NULL,0,

        FALSE,

        NULL,

        &IoStatusBlock);

其中，pTargetDeviceObject指向ip过滤驱动程序的设备对象；HookInfo为PF_SET_EXTENSION_HOOK_INFO结构，该结构中包含了回调函数的地址。当清除回调函数时，将该结构中的函数指针赋值为NULL即可。

Filter-hook驱动程序通过调用IoBuildDeviceIoControlRequest函数建立IRP，filter-hook驱动程序将所需的参数传入。其中一个为ip过滤驱程的设备对象，filter-hook驱程可以使用IoGetDeviceObjectPointer函数。这时，要将ip过滤驱程的设备对象的名字作为参数传入，还有SYNCHRONIZE，GENERIC_READ和GENERIC_WRITE。这些参数表明这三种访问权限是必需的。如果调用成功，IoGetDeviceObjectPointer返回目标设备对象和文件对象。Ip过滤驱动程序的设备对象的名字需要使用/Device/ipfilterdriver的Unicode字符串。

然后使用IoCallDriver函数提交IRP。

PF_SET_EXTENSION_HOOK_INFO结构的定义如下，其中包含回调函数的指针：

typedef struct _PF_SET_EXTENSION_HOOK_INFO

{

    PacketFilterExtensionPtr       ExtensionPointer;

} PF_SET_EXTENSION_HOOK_INFO, *PPF_SET_EXTENSION_HOOK_INFO;

 

成员ExtensionPointer是指向hook回调函数的指针。通过该结构完成向ip过滤驱动程序注册hook函数。如果ExtensionPointer为NULL，则从ip过滤驱动程序中清除回调函数。