Partager via

NdisReEnumerateProtocolBindings (Compact 2013)

  • Article

3/26/2014

This 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 currently not bound.

Syntax

VOID NdisReEnumerateProtocolBindings(
  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 NULL ProtocolBindingContext 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 currently not bound.

An intermediate driver should call NdisReEnumerateProtocolBindings after its ProtocolNetPnPEvent function receives NetEventReconfigure on a NULL ProtocolBindingContext. 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 currently not bound.

Requirements

Header

ndis.h

See Also

Reference

NDIS Functions for Protocol Drivers
ProtocolBindAdapter
MiniportInitializeEx
NdisRegisterProtocolDriver
ProtocolBindAdapterEx
ProtocolNetPnPEvent
ProtocolUnbindAdapterEx