NDIS小端口驱动(九)

PCIe设备难免会遇到一些重置设备的请求，例如重置总线的时候，但是由于NIC网卡的多样性，重置设备确实也有许多要注意的地方，另外还有一些包含WDM的NDIS驱动

微型端口驱动程序硬件重置

微型端口驱动程序必须向 NdisMRegisterMiniportDriver 注册 MiniportResetEx 函数。

MiniportResetEx 可以通过调用 NdisMResetComplete 以同步或异步方式完成,请参阅下图:

MiniportResetEx 应：

禁用进一步的中断；
清除与正在进行的任何发送关联的数据。例如，在用于 DMA设备的总线主直接内存访问的环形缓冲区上，应清除用于发送缓冲区的指针。反序列化和面向连接的微型端口驱动程序必须为任何排队发送请求返回NDIS_STATUS_REQUEST_ABORTED；
将硬件状态和微型端口驱动程序的内部状态还原到重置操作之前存在的状态；

微型端口驱动程序负责还原设备的硬件状态，但多播地址、数据包筛选器、任务卸载设置和唤醒模式除外。这些设置由微型端口驱动程序或 NDIS 还原。微型端口驱动程序通过在 AddressingReset 参数中返回布尔值来确定谁负责还原这些设置。

如果微型端口驱动程序在 AddressingReset 参数中返回 FALSE，微型端口驱动程序会将其多播地址、数据包筛选器、任务卸载设置和唤醒模式还原到其初始状态。如果微型端口驱动程序在 AddressingReset 中返回 TRUE，则 NDIS 调用无连接微型端口驱动程序的 MiniportOidRequest 函数或面向连接的微型端口驱动程序的 MiniportCoOidRequest 函数来设置以下配置设置：

通过 OID_GEN_CURRENT_PACKET_FILTER的一组请求筛选网络数据包；
通过 OID_802_3_MULTICAST_LIST集请求的多播地址列表；
任务通过 OID_OFFLOAD_ENCAPSULATION集请求卸载封装设置；
通过一组 OID_PNP_ADD_WAKE_UP_PATTERN请求的电源管理唤醒模式。注意从 NDIS 6.20 开始，微型端口驱动程序必须还原通过 OID_PM_ADD_WOL_PATTERN 设置的唤醒模式；

微型端口驱动程序停止处理程序

NDIS 微型端口驱动程序必须向 NdisMRegisterMiniportDriver 提供 MiniportHaltEx 函数。

MiniportHaltEx 应撤消 MiniportInitializeEx 执行的所有操作。例如，NDIS 微型端口驱动程序可能：

释放可用端口；
释放 MiniportInitializeEx 声明的所有硬件资源；
通过调用 NdisMDeregisterInterruptEx 释放中断资源；
释放 MiniportInitializeEx 分配的任何内存；
停止 NIC，除非 MiniportShutdownEx 函数已将 NIC 还原到其初始状态；

下图演示了卸载微型端口驱动程序。

MiniportHaltEx 应在返回之前完成卸载驱动程序所需的操作。如果微型端口驱动程序具有任何未完成的接收指示 (即已收到它已指示到 NDIS 但 NDIS 尚未返回) 的网络数据，则 MiniportHaltEx 不得返回，直到此类数据返回到微型端口驱动程序的 MiniportReturnNetBufferLists 函数。

上图显示了一组可由 MiniportHaltEx 函数进行的调用。这些调用只是可以进行的调用的子集。实际的调用集取决于微型端口驱动程序的先前操作。如果微型端口驱动程序由于硬件问题或无法获取所需的资源而无法成功初始化网络适配器，则微型端口驱动程序可以在 MiniportInitializeEx 中执行这些相同的调用。在这种情况下， MiniportInitializeEx 应通过撤消驱动程序以前的操作来卸载驱动程序。否则， MiniportHaltEx 将撤消 MiniportInitializeEx 的操作。

以下列表描述了反向微型端口驱动程序可能执行的某些操作所需的调用：

如果微型端口驱动程序注册了中断，则应调用 NdisMDeregisterInterruptEx；
如果微型端口驱动程序设置了计时器或计时器，则应为其创建的每个计时器调用 NdisCancelTimerObject 。如果调用 NdisCancelTimerObject 失败，则计时器可能已触发。在这种情况下，微型端口驱动程序应等待计时器处理程序完成，然后再从 MiniportHaltEx 返回；
如果微型端口驱动程序使用 NdisAllocateMemoryWithTagPriority 分配了任何内存，则应调用 NdisFreeMemory 来释放该内存；
如果微型端口驱动程序使用 NdisMAllocateSharedMemory 或 NdisMAllocateSharedMemoryAsyncEx 分配了任何内存，则应调用 NdisMFreeSharedMemory 来释放该内存；
如果微型端口驱动程序使用 NdisAllocateNetBufferPool 为数据包描述符池分配并初始化了存储，则它应调用 NdisFreeNetBufferPool 来释放该存储；
如果微型端口驱动程序已分配或保留任何硬件资源，则应返回这些资源。例如，如果微型端口驱动程序在 NIC 上映射了 I/O 端口范围，则应通过调用 NdisMDeregisterIoPortRange 释放端口；

NDIS库的下端是WDM框架，或者说大部分内核库的底层都是WDM框架，不过，有一些是特殊的情况，例如1394其实也可以组局域网，好吧，这是非常冷门的知识。

具有 Microsoft Windows 驱动程序模型 (WDM) 较低接口的微型端口驱动程序也称为 NDIS-WDM 微型端口驱动程序。这种类型的微型端口驱动程序：

使用 WDM 下边缘；
可以调用 NDIS 和非 NDIS 函数。但是，如果可能，微型端口驱动程序应调用 NDIS 函数；
可以初始化一个微型端口实例，该实例用于控制连接到特定总线并通过该总线与这些设备通信的设备；

例如，控制通用串行总线 (USB) 或 IEEE 1394 (Firewire) 总线上的设备的微型端口驱动程序必须在其上边缘公开标准 NDIS 微型端口驱动程序接口，并将类接口用于其下边缘的特定总线。此类微型端口驱动程序通过将 I/O 请求数据包 (IRP) 发送到总线来与连接到总线的设备通信。

包含 WDM 下边缘的微型端口驱动程序

具有 WDM 下边缘的微型端口驱动程序 (NDIS-WDM 微型端口驱动程序) 遵循 WDM 规则，该规则指定 WDM 头文件必须包含在驱动程序的源文件中。 NDIS-WDM 微型端口驱动程序需要 WDM 头文件在其下边缘调用内核模式例程。通常，NDIS 微型端口驱动程序应仅调用 NDIS 提供的函数。此限制通过 NDIS 在 NDIS 驱动程序部分的图中环绕 NDIS 微型端口驱动程序的方式显示。尽管典型的 NDIS 微型端口驱动程序不称为 WDM 驱动程序，但它们间接遵循 WDM 规则，因为 NDIS 本身遵循 WDM 规则。

下图显示了一个 NDIS-WDM 微型端口驱动程序，该驱动程序使用 WDM 下边缘与 USB 驱动程序堆栈进行接口：

以下列表描述了上图所示的组件：

IPX/SPX 兼容和 TCP/IP：使用基础微型端口驱动程序传输数据包的 NDIS 协议驱动程序；
NDIS： Ndis.sys 驱动程序，在分层网络驱动程序之间提供标准接口；
适用于 USB 的 NDIS-WDM 微型端口驱动程序：与 USB 驱动程序堆栈接口的 NDIS-WDM 微型端口驱动程序；
USB 客户端驱动程序：供应商提供的其他 USB 客户端驱动程序；
USB 类接口： USB 客户端驱动程序可用于与 USB 驱动程序堆栈接口的 USB 例程和 I/O 请求；
USB 驱动程序堆栈： USB 设备的驱动程序堆栈；

注册 WDM 下边缘的微型端口驱动程序函数

具有 WDM 下边缘的微型端口驱动程序必须在其 DriverEntry 例程中调用 NdisMRegisterMiniportDriver 函数，以便向 NDIS 库注册某些入口点函数。这些入口点函数组成微型端口驱动程序的上边缘，如初始化微型端口驱动程序中所述。但是，设置某些入口点函数不需要 WDM 下边缘的微型端口驱动程序。例如，由于以下原因，未设置以下入口点函数：

MiniportInterrupt、 MiniportInterruptDPC、 MiniportEnableInterruptEx 和 MiniportDisableInterruptEx：由于微型端口驱动程序不会从物理网络接口卡 (NIC) 接收中断，因此它不需要这些入口点例程。当数据包到达用于微型端口驱动程序的总线时，特定总线的驱动程序会收到中断。然后，总线驱动程序通知微型端口驱动程序。
MiniportSharedMemoryAllocateComplete：由于微型端口驱动程序不分配共享内存，因此未指定完成入口点例程。
MiniportCheckForHangEx：微型端口驱动程序可以依赖 NDIS，根据超时的发送和请求来确定其微型端口实例是否已停止响应，因此通常不需要此例程。

初始化包含 WDM 下边缘的微型端口驱动程序

操作系统加载微型端口驱动程序后，NDIS 调用微型端口驱动程序的 MiniportInitializeEx 函数来初始化微型端口驱动程序管理的微型端口实例。若要通过具有 WDM 下边缘的微型端口实例进行通信，微型端口驱动程序必须检索特定信息来设置其通信。

初始化此微型端口实例期间，微型端口驱动程序必须调用 NdisMGetDeviceProperty 函数，以检索通过 WDM 接口设置与微型端口实例通信所需的设备对象。在此调用中，微型端口驱动程序将句柄传递到 MiniportAdapterHandle 参数中的微型端口实例，以及接收指向 DEVICE_OBJECT 结构的指针的缓冲区。微型端口驱动程序使用检索到下一个设备对象的指针 ( NextDeviceObject 参数) 来创建和提交 IRP。

具有 WDM 下边缘的微型端口驱动程序必须是反序列化的微型端口驱动程序。反序列化微型端口驱动程序在没有足够的资源立即处理这些请求时，会在内部管理自己的发送和接收请求队列;如果微型端口驱动程序未反序列化，则 NDIS 将管理此队列。 NDIS-WDM 微型端口驱动程序必须反序列化，因为它在 NDIS 调用的上下文之外发送和接收数据包。在初始化微型端口实例期间，NDIS-WDM 微型端口驱动程序必须指定反序列化功能。所有 NDIS 6.0 及更高版本的微型端口驱动程序都已反序列化。

请注意，NDIS-WDM 微型端口驱动程序不能是中间驱动程序，在顶部公开微型端口驱动程序接口的驱动程序，在底部为协议驱动程序接口。

WDM 下边缘的实施提示和要求

NDIS-WDM 微型端口驱动程序可以调用 NDIS 和非 NDIS 函数。例如，这些非 NDIS 函数包括 WDM 内核模式支持特定总线驱动程序接口的例程和函数。

实现 NDIS-WDM 微型端口驱动程序时，请记住以下事项：

1. 生成 NDIS-WDM 微型端口驱动程序需要在包含 Ndis.h 头文件之前定义 NDIS_WDM 标志。定义 NDIS_WDM 标志可确保 Ndis.h 自动包含相应的 WDM 头文件。 NDIS_WDM 标志应嵌入在微型端口驱动程序源代码的开头，或在微型端口驱动程序的 Sources 文件中设置。 NDIS-WDM 微型端口驱动程序需要 WDM 头文件来调用内核模式例程，例如 IoCallDriver 和 IoAllocateIrp。

2. 特定总线驱动程序接口的函数调用需要该总线驱动程序的头文件。

3. 不建议在同一源文件中包含 NDIS 和非 NDIS 标头，因为它们可能不兼容。也就是说，应为调用 NDIS 函数的代码和调用非 NDIS 函数的代码创建单独的源文件。

4. NDIS-WDM 微型端口驱动程序应调用相应的 NDIS 函数来分配和释放资源，除非 NDIS-WDM 微型端口驱动程序在以下方案中分配和释放资源：

a. 资源（通常是内存资源）由 NDIS-WDM 微型端口驱动程序分配，稍后由非 NDIS 实体（如总线驱动程序接口）发布；
b. 资源（通常是内存资源）由非 NDIS 实体分配，稍后由 NDIS-WDM 微型端口驱动程序发布；
对于上述方案，NDIS-WDM 微型端口驱动程序应调用相应的 WDM 例程来为非 NDIS 实体分配或释放资源。