NDIS Filter Drivers指南

Filter Drivers主要包括以下特性:   1) 一个Filter Drivers实例叫Filter Module。Filter Module附加在一个适配器的微端口驱动上， 来自相同或不同Filter Drivers的多个Filter Module都可以被堆叠在一个网络适配器上   2) 在Filter Module被安装到驱动栈时，之上的协议驱动和之下的微端口驱动都不需要提供额外的支持功能   3) 因为Filter Module不像中间层驱动（intermediate driver）那样提供一个虚拟的微口，也不与某个设备对象联结，所以在微端口适配器(miniport adapter)之上的Filter Module 功能相当于一个修过过版本的微端口适配器(miniport adapter)。（原文：Because filter drivers do not implement virtual miniports like an intermediate driver, filter drivers are not associated with a device object. A miniport adapter with overlying filter modules functions as a modified version of the miniport adapter.）   4) NDIS使用配置信息来到决定一个Filter Module附加到一个网络适配器栈上的顺序   5) 在不用拆除整驱动栈的情况下，NDIS可以动态的插入、删除Filter Module或进行重新配置   6) 当NDIS重起驱动栈的时候协议驱动可以获得在栈上的Filter Module列表   7) Filter Drivers可以过滤下层网络适配器上绝大部分的通信。Filter Module不联结某特定的绑定(Filter modules are not associated with any particular binding between overlying protocol drivers and the miniport adapter.)   8) Filter Drivers 可以选择为过滤服务也可以选择为分流的不过滤服务，选择为哪一种是可以动态配置的（Filter drivers can select the services that are filtered and can be bypassed for the services that are not filtered. The selection of the services that are bypassed and the services that are filtered can be reconfigured dynamically.）   9) NDIS 保证有效的上下文空间，也不就是说Filter Drivers不要需要通代码COPY缓冲区来获得上下文空间   ### NDIS Filter Drivers指南 #### 一、介绍NDIS Filter Drivers NDIS (Network Driver Interface Specification) Filter Drivers 是一种特殊的网络驱动程序，它们被设计用于在网络驱动程序栈中执行过滤和其他高级服务。这类驱动程序主要负责拦截并处理通过网络适配器传输的数据包。 ##### 1.1 Filter Drivers特性 1. **Filter Module的概念**：Filter Drivers 的实例被称为 Filter Module。这些模块可以附加在任何网络适配器的微端口驱动程序之上，并且可以在同一适配器上堆叠多个来自不同 Filter Drivers 的 Filter Module。这种灵活性使得系统能够同时支持多种过滤机制。 2. **无需额外支持功能**：当 Filter Module 被添加到驱动程序栈中时，位于其上方的协议驱动程序和下方的微端口驱动程序不需要为此提供额外的支持功能。这意味着 Filter Module 可以独立运作而不会干扰其他驱动程序的操作。 3. **修改版的微端口适配器**：不同于中间层驱动程序提供的虚拟微端口，Filter Module 不与特定的设备对象关联。因此，在微端口适配器之上堆叠 Filter Module 类似于创建了一个修改版的微端口适配器。这种设计使得 Filter Module 能够更高效地处理数据包而不必维护额外的状态信息。 4. **动态配置和插入**：NDIS 使用配置信息来确定 Filter Module 在适配器栈上的排列顺序，并且能够在不完全移除整个驱动程序栈的情况下动态地插入或删除 Filter Module。这种动态性极大地提高了系统的灵活性和适应能力。 5. **协议驱动获取 Filter Module 列表**：当 NDIS 重启驱动程序栈时，协议驱动程序可以获得栈上所有 Filter Module 的列表。这有助于协议驱动程序了解网络数据流所经过的所有过滤层。 6. **通信过滤**：Filter Module 可以过滤网络适配器上的大部分通信。它们不与特定的绑定关联，即它们不会绑定到特定的协议驱动程序和微端口适配器之间的连接。 7. **过滤和服务选择**：Filter Drivers 可以选择性地过滤服务或者选择性地绕过某些服务。这些选择可以在运行时动态配置，从而提供高度的定制化能力。 8. **上下文空间**：NDIS 会确保 Filter Drivers 有足够的上下文空间，因此 Filter Drivers 不需要通过复制缓冲区来获得上下文空间。这减少了内存复制操作，提高了性能。 #### 二、编写NDIS Filter Drivers NDIS Filter Drivers 的编写涉及多个方面，包括初始化、卸载、状态管理等。 1. **初始化**：初始化 Filter Driver 通常涉及创建 Filter Module 并将其添加到适配器栈中。这个过程还包括配置 Filter Module 的属性和行为。 2. **卸载**：卸载 Filter Driver 包括从适配器栈中移除 Filter Module 和释放相关资源。 3. **状态和操作**：Filter Module 具有不同的状态，例如就绪、暂停等。根据不同的状态，Filter Module 可以执行不同的操作，如过滤数据包或传递数据包给下一个驱动程序。 4. **附加和分离 Filter Module**：可以动态地将 Filter Module 添加到适配器栈中或从中移除。这种灵活性允许在不重启系统的情况下更改过滤策略。 5. **重启和暂停**：Filter Module 可以被重启或暂停，以响应不同的系统需求或事件。 6. **数据绕过模式**：Filter Drivers 支持数据绕过模式，即可以选择性地绕过某些数据包的过滤，以提高性能或满足特定需求。 7. **缓冲区管理**：Filter Drivers 需要有效地管理缓冲区，以确保数据包的正确处理。 8. **发送和接收数据**：Filter Drivers 可以发送和接收数据包，同时也支持取消发送请求和处理接收数据。 9. **OID 请求**：Filter Drivers 可以过滤或发起 OID (OID Object Identifier) 请求，这些请求通常用于配置和查询网络适配器的状态。 10. **PnP 事件通知**：Filter Drivers 可以接收 PnP (Plug and Play) 事件通知，以便于响应硬件的变化。 11. **状态指示**：Filter Module 可以向系统报告其当前状态，如是否正在处理数据包或处于暂停状态。 #### 三、安装NDIS Filter Drivers 安装 NDIS Filter Drivers 涉及配置驱动程序的绑定关系以及 INF 文件设置等步骤。 1. **绑定关系**：通过 INF 文件或其他方式指定 Filter Driver 的绑定关系，确保 Filter Module 能够正确地安装在网络适配器上。 2. **INF 文件设置**：INF 文件包含了 Filter Driver 的配置信息，包括所需的驱动程序、设备类型、服务类型等。正确的 INF 文件设置对于 Filter Driver 的成功安装至关重要。 3. **访问配置信息**：Filter Drivers 可以访问配置信息，以确定其在适配器栈中的位置以及其他相关的配置参数。 以上内容概括了 NDIS Filter Drivers 的主要概念和特点，以及编写和安装此类驱动程序的基本步骤。这些知识对于开发人员来说是非常宝贵的，可以帮助他们在开发网络过滤解决方案时更加得心应手。