NdisReEnumerateProtocolBindings 函数 (ndis.h)

NdisReEnumerateProtocolBindings 函数会导致 NDIS 为驱动程序配置绑定的每个微型端口适配器调用协议驱动程序的 ProtocolBindAdapterEx 函数一次,而驱动程序当前未绑定到该适配器。

语法

void NdisReEnumerateProtocolBindings(
  [in] NDIS_HANDLE NdisProtocolHandle
);

参数

[in] NdisProtocolHandle

表示调用协议驱动程序的句柄。 驱动程序通过上一次调用获取此句柄 NdisRegisterProtocolDriver 函数。

返回值

没有

言论

协议驱动程序可以调用 NdisReEnumerateProtocolBindings 函数以重新绑定到一个或多个微型端口适配器。

协议驱动程序无法从 ProtocolBindAdapterEx上下文中调用 NdisReEnumerateProtocolBindings ProtocolUnbindAdapterEx 函数。 此外,协议驱动程序无法从 ProtocolNetPnPEvent 函数的上下文中调用 NdisReEnumerateProtocolBindings
ProtocolNetPnPEvent 的 protocolBindingContext 参数不 NULL 但是,如果 ProtocolBindingContext为 NULL,协议驱动程序可以从 ProtocolNetPnPEvent 上下文中调用 NdisReEnumerateProtocolBindingsNULLProtocolBindingContext 值指示该事件适用于所有绑定。

调用 NdisReEnumerateProtocolBindings 返回后,NDIS 可能会完成绑定作。 也就是说,NDIS 可能会完成协议驱动程序配置为绑定的微型端口适配器的绑定,但协议驱动程序在以后不会绑定到该适配器。

中间驱动程序应在 ProtocolNetPnPEvent 函数在 NULLProtocolBindingContext 上接收 NetEventReconfigure 后调用 NdisReumerateProtocolBindings。 然后,NDIS 为每个微型端口适配器调用驱动程序的 ProtocolBindAdapterEx 函数,该适配器配置为绑定驱动程序,但驱动程序当前未绑定到该适配器。

要求

要求 价值
最低支持的客户端 Windows Vista 中支持 NDIS 6.0 和 NDIS 5.1 驱动程序(请参阅 NdisReEnumerateProtocolBindings (NDIS 5.1) 。 支持 NDIS 5.1 驱动程序(请参阅 Windows XP 中的 NdisReEnumerateProtocolBindings (NDIS 5.1)。
目标平台 桌面
标头 ndis.h (包括 Ndis.h)
Ndis.lib
IRQL PASSIVE_LEVEL
DDI 符合性规则 Irql_Miscellaneous_Function(ndis)NdisReEnumerateProtocolBindings(ndis)

另请参阅

MiniportInitializeEx

NdisRegisterProtocolDriver

ProtocolBindAdapterEx

ProtocolNetPnPEvent

ProtocolUnbindAdapterEx