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 上下文中调用 NdisReEnumerateProtocolBindings。 NULLProtocolBindingContext 值指示事件应用于所有绑定。
对 NdisReEnumerateProtocolBindings 的调用返回后,NDIS 可能会完成绑定操作。 也就是说,NDIS 可能会完成对微型端口适配器的绑定,该微型端口适配器的协议驱动程序已配置为绑定,但协议驱动程序在以后不会绑定到这些适配器。
中间驱动程序应在其 ProtocolNetPnPEvent 函数收到 NULLProtocolBindingContext 上的 NetEventReconfigure 后调用 NdisReEnumerateProtocolBindings。 然后,NDIS 为每个微型端口适配器调用驱动程序的 ProtocolBindAdapterEx 函数一次,驱动程序已配置为绑定,但驱动程序当前未绑定到该适配器。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 支持 NDIS 6.0 和 NDIS 5.1 驱动程序 (请参阅 Windows Vista 中的 NdisReEnumerateProtocolBindings (NDIS 5.1) ) 。 支持 NDIS 5.1 驱动程序 (请参阅 Windows XP 中的 NdisReEnumerateProtocolBindings (NDIS 5.1) ) 。 |
目标平台 | 桌面 |
标头 | ndis.h (包括 Ndis.h) |
Library | Ndis.lib |
IRQL | PASSIVE_LEVEL |
DDI 符合性规则 | Irql_Miscellaneous_Function (ndis) , NdisReEnumerateProtocolBindings (ndis) |