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(
  _In_  NDIS_HANDLE NdisProtocolHandle
);

Parameters

NdisProtocolHandle [in]

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

Version

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.

Header

Ndis.h (include Ndis.h)

IRQL

PASSIVE_LEVEL

DDI compliance rules

Irql_Miscellaneous_Function, NdisReEnumerateProtocolBindings

See also

MiniportInitializeEx
NdisRegisterProtocolDriver
ProtocolBindAdapterEx
ProtocolNetPnPEvent
ProtocolUnbindAdapterEx

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft