NDIS小端口驱动(四)

NDIS中断相关

1. 注册和取消注册中断： 微型端口驱动程序调用 NdisMRegisterInterruptEx 来注册中断。 驱动程序分配并初始化 NDIS_MINIPORT_INTERRUPT_CHARACTERISTICS 结构，以指定中断特征和函数入口点，驱动程序将结构传递给 NdisMRegisterInterruptEx，驱动程序调用 NdisMDeRegisterInterruptEx 函数以释放以前使用 NdisMRegisterInterruptEx 分配的资源。

2. 处理 NDIS 微型端口驱动程序的中断：当 NIC 或与 NIC 共享中断的另一台设备生成中断时，NDIS 调用 MiniportInterrupt 函数。如果基础 NIC 未生成中断，MiniportInterrupt 应立即返回 FALSE。 否则，它在处理中断后返回 TRUE 。

微型端口驱动程序应在其 MiniportInterrupt 函数中尽可能少地执行工作。 它应将 I/O 操作延迟到 MiniportInterruptDPC 函数。 NDIS 调用 MiniportInterruptDPC 来完成中断的延迟处理。若要在 MiniportInterrupt 返回后将其他 DPC 排队，微型端口驱动程序将设置 MiniportInterrupt 函数的 TargetProcessors 参数的位。

若要从 MiniportInterrupt 或 MiniportInterruptDPC 请求其他 DPC，微型端口驱动程序调用 NdisMQueueDpc 函数。微型端口驱动程序可以调用 NdisMQueueDpc ，以请求其他处理器的其他 DPC 调用。

3. 与中断同步：如果微型端口驱动程序的 MiniportInterrupt 函数将资源（如 NIC 寄存器或状态变量）与以较低 IRQL 运行的另一个 MiniportXxx 函数共享，则 MiniportXxx 函数必须调用 NdisMSynchronizeWithInterruptEx。 此调用可确保微型端口驱动程序的 MiniportSynchronizeInterrupt 函数以同步且多处理器安全的方式访问共享资源。

4. 中断调解：为了减少中断数，许多 NIC 使用中断审查。 使用中断审查时，NIC 硬件在收到数据包后不会立即生成中断。 相反，硬件会等待更多数据包到达或超时过期，然后再生成中断。 硬件供应商指定最大数据包数、超时间隔或其他中断审查算法。数据包的测量往返时间是确定两个终结点之间的网络带宽的最常用技术之一。 但是，启用中断审查后，接收数据包不会立即产生中断，因此，特定数据包的感知往返时间将大于平均时间。

为了准确测量数据包的往返时间，NDIS 提供了按需禁用和启用中断审查的功能。所有 NDIS 6.0 及更高版本的微型端口驱动程序都必须支持 OID_GEN_INTERRUPT_MODERATION OID。 如果微型端口驱动程序不支持中断审查，则驱动程序必须在NDIS_INTERRUPT_MODERATION_PARAMETERS结构的 InterruptModeration 成员中指定 NdisInterruptModerationNotSupported。

NDIS 6.0 及更高版本的微型端口驱动程序必须同时支持 OID_GEN_INTERRUPT_MODERATION OID 集和查询请求。 设置请求指示微型端口驱动程序启用或禁用中断审查，查询请求报告中断审查的当前状态。默认情况下，支持中断审查的微型端口驱动程序应启用此功能，除非注册表中的 InterruptModeration 标准关键字 (keyword) 禁用此功能。

微型端口适配器 OID 请求

NDIS 定义对象标识符 (OID) 值来标识微型端口适配器参数，其中包括设备特征、可配置的设置和统计信息等操作参数。

对于 NDIS 6.1 及更高版本的微型端口驱动程序，NDIS 提供 直接 OID 请求接口。 直接 OID 请求路径支持经常查询或设置的 OID 请求。 对于 NDIS 驱动程序，直接 OID 请求接口是可选的。

对于 NDIS 6.80 及更高版本的微型端口驱动程序，NDIS 提供 同步 OID 请求接口。 同步 OID 请求路径支持需要同步的 OID 或不应由筛选器驱动程序(如 RSSv2 OID)排队的 OID。 同步 OID 请求接口对于 NDIS 驱动程序是可选的，但如果微型端口驱动程序播发对 RSSv2 的支持，则是必需的。

1. 微型端口适配器 OID 请求序列化

对微型端口适配器的所有 OID 请求都由 NDIS 序列化，直接 OID 请求除外，这些请求在设计上未序列化。 在完成任何挂起的请求之前，微型端口适配器不会收到新的 OID 请求。 因此，微型端口适配器必须立即完成 OID。

备注:建议在 1000 毫秒或 1 秒内完成 OID 请求，这样用户就不会注意到性能有任何延迟。 有关 OID 请求计时的特定信息，请参阅 NdisTimedOidComplete 驱动程序验证程序规则。

此 OID 序列化规则的一个例外是，对于使用 WDI 的Wi-Fi微型端口适配器，如果它们花费的时间太长而无法完成以前的 OID，则可能会看到第二个 OID 请求。 以下示例说明在这种情况下会发生什么情况：

• 第一个 OID 请求传递到 WDI 微型端口适配器；
• NIC 不会在驱动程序指定的时间限制内响应 OID；
• WDI 调用驱动程序的 MINIPORT_WDI_ADAPTER_HANG_DIAGNOSE 回调函数来收集有关 NIC 的诊断数据；
• 第一个 OID 不再被视为阻止序列化。 这意味着 WDI 微型端口适配器现在可以接收其他 OID 请求，即使第一个 OID 已序列化。 但是，这些其他 OIDS 也会序列化，这意味着 WDI 微型端口适配器不会同时处理 (第一个仍挂起的 OID以及第二个 OID) ；

2. 处理微型端口适配器中的 OID 请求

NDIS 调用微型端口驱动程序的 MiniportOidRequest 函数以提交 OID 请求以查询或设置驱动程序中的信息。 NDIS 代表它自己调用 MiniportOidRequest 函数，或者代表调用 NdisOidRequest 或 NdisFOidRequest 函数的过度驱动程序调用 MiniportOidRequest 函数。

NDIS 传递 MiniportOidRequest 指向包含请求信息的 NDIS_OID_REQUEST 结构的指针。 请求结构包含一个OID_Xxx标识符，该标识符指示请求的类型以及用于定义请求数据的其他成员。

Timeout 成员指定请求的超时时间（以秒为单位）。 如果超时在驱动程序完成请求之前过期，NDIS 可以重置驱动程序或取消请求。

RequestId 成员指定请求的可选标识符。 微型端口驱动程序可以将状态指示的 RequestId 成员设置为从关联 OID 请求的 RequestId 成员获取的值。 通常，微型端口驱动程序可以忽略此成员。 如果驱动程序必须设置此成员，则特定 OID 的引用页将提供所需的值。 有关状态指示的详细信息，请参阅 适配器状态指示。

成功处理 OID 集请求的微型端口驱动程序必须在从 OID 集请求返回时在 NDIS_OID_REQUEST 结构中设置 SupportedRevision 成员。 SupportedRevision 成员通知发起方驱动程序支持的修订请求。 例如，微型端口驱动程序可以创建Xxx_REVISION_2结构，提供适合Xxx_REVISION_1结构的值，并使用零填充结构的其余部分。 微型端口驱动程序将在 SupportedRevision 成员中报告Xxx_REVISION_1。 在这种情况下，可支持Xxx_REVISION_2的协议驱动程序将使用微型端口驱动程序支持的Xxx_REVISION_1信息。 

微型端口驱动程序可以通过返回成功或失败状态同步完成 OID 请求。

微型端口驱动程序可以通过返回NDIS_STATUS_PENDING异步完成 OID 请求。 在这种情况下，微型端口驱动程序必须调用 NdisMOidRequestComplete 函数才能完成操作。

如果 MiniportOidRequest 返回NDIS_STATUS_PENDING，则在挂起的请求完成之前，NDIS 不会使用针对适配器的另一个请求调用 MiniportOidRequest 。

NDIS 可以调用微型端口驱动程序的 MiniportCancelOidRequest 函数来取消 OID 请求。

3. 微型端口适配器直接 OID 请求

为了支持直接 OID 请求路径，微型端口驱动程序在NDIS_MINIPORT_DRIVER_CHARACTERISTICS结构中提供 MiniportXxx 函数入口点，NDIS 为微型端口驱动程序提供 NdisMXxx 函数。

直接 OID 请求接口类似于标准 OID 请求接口。 例如， NdisMDirectOidRequestComplete 和 MiniportDirectOidRequest 函数类似于 NdisMOidRequestComplete 和 MiniportOidRequest 函数。

注意 NDIS 6.1 支持用于直接 OID 请求接口的特定 OID。 不支持 NDIS 6.1 和某些 NDIS 6.1 OID 之前存在的 OID。

微型端口驱动程序必须能够处理未序列化的直接 OID 请求。 与标准 OID 请求接口不同，NDIS 不会将直接 OID 请求与通过直接 OID 接口或标准 OID 请求接口发送的其他请求序列化。 此外，微型端口驱动程序必须能够在 IRQL <= DISPATCH_LEVEL 处理直接 OID 请求。

若要支持直接 OID 请求接口，请使用标准 OID 请求接口的文档。下表显示了直接 OID 请求接口中的函数与标准 OID 请求接口之间的关系。

直接 OID 函数	标准 OID 函数
MiniportDirectOidRequest	MiniportOidRequest
MiniportCancelDirectOidRequest	MiniportCancelOidRequest
NdisMDirectOidRequestComplete	NdisMOidRequestComplete

4. 微型端口适配器同步 OID 请求

为了支持同步 OID 请求路径，微型端口驱动程序在调用 NdisMRegisterMiniportDriver 函数时，在 NDIS_MINIPORT_DRIVER_CHARACTERISTICS 结构中提供 MiniportSynchronousOidRequest 函数入口点。

对于微型端口驱动程序， 同步 OID 请求接口 不同于常规和直接 OID 请求接口，即微型端口驱动程序不必注册异步完成回调函数。 这是因为路径的同步性质。 口。

备注: NDIS 6.80 支持与同步 OID 请求接口配合使用的特定 OID。 不支持 NDIS 6.80 和某些 NDIS 6.80 OID 之前存在的 OID。 

若要支持同步 OID 请求接口，请使用标准 OID 请求接口的文档。 下表显示了同步 OID 请求接口和标准 OID 请求接口中的函数之间的关系：

同步 OID 函数	标准 OID 函数
MiniportSynchronousOidRequest	MiniportOidRequest

微型端口驱动其它信息 

1. 微型端口适配器状态指示

微型端口驱动程序调用 NdisMIndicateStatusEx 函数来报告微型端口适配器的状态更改。 微型端口驱动程序将 NdisMIndicateStatusEx 传递指向包含状态信息的 NDIS_STATUS_INDICATION 结构的指针。

状态指示包括用于标识状态类型和状态更改原因的信息。

微型端口驱动程序应将 SourceHandle 成员设置为 NDIS 传递给 MiniportInitializeEx 函数的 MiniportAdapterHandle 参数的句柄。 如果状态指示与 OID 请求相关联，微型端口驱动程序可以设置 DestinationHandle 和 RequestId 成员，以便 NDIS 可以提供特定协议绑定的状态指示。

2. 微型端口适配器设备 PnP 事件通知

NDIS 调用微型端口驱动程序的 MiniportDevicePnPEventNotify 函数，以通知驱动程序即插即用 (PnP) 事件。

NDIS 提供描述 PnP 事件的事件代码。 代码可以指示适配器已意外从系统中删除，或者主机系统的电源配置文件已更改。

如果事件代码指示电源配置文件已更改，则 NDIS 还会指示更改的类型。 系统使用电池电源运行，或者系统使用交流电源运行。

微型端口驱动程序应相应地调整适配器设置。 

3. 微型端口适配器挂起检查和重置操作

对于所有 NDIS 6.83 及更高版本的驱动程序，不建议检查挂起 (CFH) 和重置操作。 

NDIS 调用 NDIS 微型端口驱动程序的 MiniportCheckForHangEx 函数来检查 NDIS 适配器的操作状态，该适配器表示网络接口卡 (NIC) 。 MiniportCheckForHangEx 检查适配器的内部状态，如果检测到适配器无法正常运行，则返回 TRUE 。

默认情况下，NDIS 大约每 2 秒调用 一次 MiniportCheckForHangEx 。 如果 MiniportCheckForHangEx 返回 TRUE，NDIS 将调用 NDIS 微型端口驱动程序的 MiniportResetEx 函数。 如果默认超时值 2 秒太小，微型端口驱动程序可以在初始化时设置不同的值，如下所示：

• 将 NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES 结构的 CheckForHangTimeInSeconds 成员设置为非零值；
• 在 NdisMSetMiniportAttributes 函数的 MiniportAttributes 参数中传递 NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES 结构；

CheckForHangTimeInSeconds 的值应大于微型端口驱动程序的初始化时间。 但是，如果驱动程序初始化所花费的时间超过 CheckForHangTimeInSeconds 秒 ，则此超时将过期，导致 NDIS 调用驱动程序的 MiniportCheckForHangEx 函数。 如果 MiniportCheckForHangEx 返回 TRUE，则 NDIS 将调用驱动程序的 MiniportResetEx 函数。 因此，应将驱动程序的 MiniportCheckForHangEx 函数与驱动程序初始化同步，以便在驱动程序尚未完成初始化时 ，MiniportCheckForHangEx 不会返回 TRUE 。

如果微型端口驱动程序在对 MiniportCheckForHangEx 的连续两次调用中未完成 OID 请求，则 NDIS 可以调用驱动程序的 MiniportResetEx 函数。 对于某些 OID 请求，如果驱动程序在对 MiniportCheckForHangEx 的连续四次调用中未完成请求，则 NDIS 会调用 MiniportResetEx。

重置操作不会影响 微型端口适配器的操作状态。 此外，重置操作正在进行时，适配器的状态可能会更改。 例如，当正在进行重置操作时，NDIS 可能会调用驱动程序的 MiniportPause 函数。 在这种情况下，驱动程序可以按任何顺序完成重置或暂停操作，同时遵循每个操作的正常要求。

对于重置操作，驱动程序可能会使传输请求数据包失败，也可以让数据包保持排队并稍后完成。 但是，应注意，在传输数据包挂起时，过分的驱动程序无法完成暂停操作。

微型端口驱动程序可以通过返回成功或失败状态同步完成重置请求。 驱动程序可以通过返回 NDIS_STATUS_PENDING异步完成重置请求。 在这种情况下，驱动程序必须调用 NdisMResetComplete 才能完成操作。

4. NDIS 6.83 及更高版本中的检查挂起和重置操作：
在 NDIS 6.83 之前的版本中，由于电池使用时间问题，不建议对 Always On、Always Connected (AOAC) 系统执行检查挂起 (CFH) 和重置操作。 但是，驱动程序仍可以通过实现可选的 MiniportCheckForHangEx 和 MiniportResetEx 回调函数在其他非 AOAC Windows 系统上使用 CFH。

从 NDIS 6.83 开始，不建议 在所有 Windows 系统上使用这些回调函数，而不考虑电源功能。 尽管在 NDIS 6.83 及更高版本中使用 CFH 不是徽标测试冲突，但 NDIS 驱动程序应使用下表来获取有关其用法的指导。

调用方	建议	说明
面向 AOAC 系统的驱动程序	不得实现	由于定期检查挂起活动而导致电池使用时间问题
面向 Windows Server 系统的驱动程序	不得实现	CPU 压力大时导致问题
虚拟 (仅限软件) 微型端口驱动程序	不得实现	没有硬件就无法重置
其他新的 NDIS 6.83 及更高版本的驱动程序	不应实现
其他现有的 NDIS 6.82 和更早代码	不需要更改，但应考虑在将来的版本中删除“挂起检查”和“重置”

5. NDIS 管理信息和 OID

每个微型端口驱动程序都包含自己的 管理信息库 (MIB) ，这是一个信息块，驱动程序在其中存储管理实体可以查询或设置的动态配置信息和统计信息。 以太网多播地址列表是配置信息的示例。 接收的广播数据包数是统计信息的一个示例。 MIB 中的每个信息元素称为对象。 为了引用每个此类托管对象，NDIS (OID) 定义对象标识符 。 因此，如果管理实体想要查询或设置特定的托管对象，则必须为该对象提供特定的 OID。

MIB 跟踪三类对象：

• 所有 NDIS 微型端口驱动程序通用的对象；
• 特定于给定介质类型（如以太网）的所有 NDIS 微型端口驱动程序的对象；
• 特定于特定供应商实现的对象；

WDK 文档的“网络参考”部分记录了 常规 和必需的媒体特定 OID。 特定网络接口卡 (NIC) 驱动程序的实现特定 OID 应在给定微型端口驱动程序随附的文档中列出和说明。

对象被归类为 操作特征 (例如，多播地址列表) 或 统计信息 接收的广播数据包，它们也分类为必需或可选。 常规类或特定于媒体的类的所有操作特征对象都是强制性的，但只有一些统计信息对象是必需的。 所有特定于实现的对象都分类为必需对象。