NdisReEnumerateProtocolBindings function

The NdisReEnumerateProtocolBindings function causes NDIS to call a protocol driver's ProtocolBindAdapterEx function one time for each miniport adapter for which the driver is configured to bind but to which the driver is not currently bound.

Syntax

void NdisReEnumerateProtocolBindings(
  NDIS_HANDLE NdisProtocolHandle
);

Parameters

NdisProtocolHandle

A handle representing the calling protocol driver. The driver obtained this handle with a previous call to the NdisRegisterProtocolDriver function.

Return Value

None

Remarks

A protocol driver can call the NdisReEnumerateProtocolBindings function to rebind to one or more miniport adapters.

Protocol drivers cannot call NdisReEnumerateProtocolBindings from within the context of the ProtocolBindAdapterEx, or ProtocolUnbindAdapterEx functions. Also, protocol drivers cannot call NdisReEnumerateProtocolBindings from within the context of the ProtocolNetPnPEvent function if the
ProtocolBindingContext parameter of ProtocolNetPnPEvent is not NULL. However, protocol drivers can call NdisReEnumerateProtocolBindings from within the context of ProtocolNetPnPEvent if ProtocolBindingContext is NULL. A NULLProtocolBindingContext value indicates that the event applies to all bindings.

NDIS might complete the binding operations after the call to NdisReEnumerateProtocolBindings returns. That is, NDIS might complete bindings to the miniport adapters for which the protocol driver is configured to bind but to which the protocol driver is not currently bound at a later time.

An intermediate driver should call NdisReEnumerateProtocolBindings after its ProtocolNetPnPEvent function receives NetEventReconfigure on a NULLProtocolBindingContext . NDIS then calls the driver's ProtocolBindAdapterEx function one time for each miniport adapter for which the driver is configured to bind but to which the driver is not currently bound.

Requirements

   
Minimum supported client Supported for NDIS 6.0 and NDIS 5.1 drivers (see NdisReEnumerateProtocolBindings (NDIS 5.1)) in Windows Vista. Supported for NDIS 5.1 drivers (see NdisReEnumerateProtocolBindings (NDIS 5.1)) in Windows XP.
Target Platform Desktop
Header ndis.h (include Ndis.h)
Library Ndis.lib
IRQL PASSIVE_LEVEL
DDI compliance rules Irql_Miscellaneous_Function, NdisReEnumerateProtocolBindings

See Also

MiniportInitializeEx

NdisRegisterProtocolDriver

ProtocolBindAdapterEx

ProtocolNetPnPEvent

ProtocolUnbindAdapterEx