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 后调用 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) |