NdisIMAssociateMiniport

This function informs NDIS that the specified lower and upper interfaces for miniport and protocol respectively belong to the same intermediate driver.

VOID NdisIMAssociateMiniport(
  NDIS_HANDLE DriverHandle,
  NDIS_HANDLE ProtocolHandle
);

Parameters

• DriverHandle
  [in] Specifies the handle to the miniport interface that is returned by NdisIMRegisterLayeredMiniport.
• ProtocolHandle
  [in] Specifies the handle to the protocol interface that is returned by NdisRegisterProtocol.

Return Values

None.

Remarks

Any NDIS intermediate driver that exports both MiniportXXX and ProtocolXXX functions calls NdisIMAssociateMiniport to inform the NDIS library about its miniport lower edge and its protocol upper edge. Such an intermediate driver calls NdisIMAssociateMiniport during its DriverEntry routine. Before an intermediate driver calls NdisIMAssociateMiniport to associate its miniport and protocol interfaces, it must first perform the following tasks:

• Calls the NdisMInitializeWrapper function to notify NDIS that it is about to register its miniport lower edge.
• Fills in an NDIS_MINIPORT_CHARCTERISTICS structure with the entry points for its MiniportXXX functions and then calls the NdisIMRegisterLayeredMiniport function to register those MiniportXXX entry points.
• Fills in an NDIS_PROTOCOL_CHARACTERISTICS structure with the entry points for its ProtocolXXX functions and then calls the NdisRegisterProtocol function to register those ProtocolXXX entry points.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Ndis.h.

See Also

DriverEntry | NdisIMRegisterLayeredMiniport | NdisMInitializeWrapper | NdisRegisterProtocol

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.