NdisReEnumerateProtocolBindings function (ndis.h)

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(
  [in] NDIS_HANDLE NdisProtocolHandle
);

Parameters

[in] 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

See also

MiniportInitializeEx

NdisRegisterProtocolDriver

ProtocolBindAdapterEx

ProtocolNetPnPEvent

ProtocolUnbindAdapterEx