NdisMResetComplete 宏 (ndis.h)
注意
对于 NDIS 6.x (Windows Vista 及更高版本) ,请改用 NdisMResetComplete 函数 (NDIS 6.x) 。
NdisMResetComplete 函数返回微型端口驱动程序之前为其返回NDIS_STATUS_PENDING的重置请求的最终状态。
语法
void NdisMResetComplete(
_M,
_S,
_A
);
参数
_M
NDIS 最初传递给 MiniportInitializeEx 函数的微型端口 适配器句柄。
_S
重置操作的最终状态刚刚完成。 返回值与为 MINIPORT_RESET回调函数列出的值相同。
_A
如果 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 运行。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 在 NDIS 5.1、NDIS 6.0 及更高版本中受支持。 有关 NDIS 5.1 驱动程序,请参阅 NdisMResetComplete (NDIS 5.1) 。 |
目标平台 | 通用 |
标头 | ndis.h (包括 Ndis.h) |
Library | Ndis.lib |
IRQL | DISPATCH_LEVEL |
DDI 符合性规则 | Irql_Miniport_Driver_Function (ndis) |