NdisMResetComplete 宏 (NDIS 6.x)

  • 项目

NdisMResetComplete 函数返回微型端口驱动程序之前返回的重置请求的最终状态NDIS_STATUS_PENDING。

语法

void NdisMResetComplete(
  NDIS_HANDLE MiniportAdapterHandle,
  NDIS_STATUS Status,
  BOOLEAN     AddressingReset
);

参数

MiniportAdapterHandle

NDIS 最初传递给 MiniportInitializeEx 函数的微型端口 适配器句柄。

Status

重置操作刚刚完成的最终状态。 返回值与 为MINIPORT_RESET回调函数列出的值相同。

AddressingReset

一个布尔值，如果 NDIS 负责还原多播地址、数据包筛选器和任务卸载信息的设置，则为 TRUE 。 在这种情况下，微型端口驱动程序负责还原 MiniportAdapterHandle 引用的网络接口卡 (NIC) 其余配置设置。

如果 AddressingReset 为 FALSE，则微型端口驱动程序负责还原 NIC 的所有配置设置。

有关详细信息，请参阅 硬件重置。

返回值

无

备注

如果 MiniportResetEx 函数返回NDIS_STATUS_PENDING，则微型端口驱动程序必须在完成重置操作时调用 NdisMResetComplete 。

协议驱动程序无法在 NDIS 6.0 及更高版本中启动重置操作。

发出软重置时，某些 NIC 会丢失所有多播地址、数据包筛选器或功能地址信息。 此类 NIC 的驱动程序在调用 NdisMResetComplete 时将 AddressingReset 设置为 TRUE，导致 NDIS 调用其 MiniportOidRequest 函数以还原寻址状态。 有关详细信息，请参阅 硬件重置。

微型端口驱动程序必须在调用 NdisMResetComplete 之前释放它持有的任何旋转锁。

在 NDIS 6.0 及更高版本中， NdisMResetComplete 的调用方必须在 IRQL <= DISPATCH_LEVEL 运行。 否则， NdisMResetComplete 的调用方必须在 IRQL = DISPATCH_LEVEL运行。

要求

要求 值
最低受支持的客户端 Windows Vista 及更高版本
标头 ndis.h
IRQL <= DISPATCH_LEVEL
DDI 符合性规则 Irql_Miniport_Driver_Function (ndis)

另请参阅

NdisMResetComplete 宏 (NDIS 5.x)