NdisReEnumerateProtocolBindings 函数会导致 NDIS 为驱动程序配置绑定的每个微型端口适配器调用协议驱动程序的 ProtocolBindAdapterEx 函数一次,而驱动程序当前未绑定到该适配器。
语法
VOID NdisReEnumerateProtocolBindings(
[in] NDIS_HANDLE NdisProtocolHandle
);
参数
[in] NdisProtocolHandle
表示调用协议驱动程序的句柄。 驱动程序通过上一次调用获取此句柄 NdisRegisterProtocolDriver 函数。
返回值
没有
言论
协议驱动程序可以调用 NdisReEnumerateProtocolBindings 函数以重新绑定到一个或多个微型端口适配器。
协议驱动程序无法从 ProtocolBindAdapterEx上下文中调用 NdisReEnumerateProtocolBindings,
ProtocolUnbindAdapterEx 函数。 此外,协议驱动程序无法从 ProtocolNetPnPEvent 函数的上下文中调用 NdisReEnumerateProtocolBindings
ProtocolNetPnPEvent 的 protocolBindingContext 参数不 NULL。 但是,如果 ProtocolBindingContext为 NULL,协议驱动程序可以从 ProtocolNetPnPEvent 上下文中调用 NdisReEnumerateProtocolBindings。
NULLProtocolBindingContext 值指示该事件适用于所有绑定。
调用 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) |