NdisIMAssociateMiniport (NDIS 5.1)
This documentation is archived and is not being maintained.

NdisIMAssociateMiniport (NDIS 5.1) function

Note   NDIS 5. x has been deprecated and is superseded by NDIS 6. x. For new NDIS driver development, see Network Drivers Starting with Windows Vista. For information about porting NDIS 5. x drivers to NDIS 6. x, see Porting NDIS 5.x Drivers to NDIS 6.0.

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

Syntax


VOID NdisIMAssociateMiniport(
  _In_ NDIS_HANDLE DriverHandle,
  _In_ NDIS_HANDLE ProtocolHandle
);

Parameters

DriverHandle [in]

Specifies the handle to the miniport driver interface that is returned by NdisIMRegisterLayeredMiniport.

ProtocolHandle [in]

Specifies the handle to the protocol interface that is returned by NdisRegisterProtocol.

Return value

None

Remarks

Any NDIS intermediate driver that exports both MiniportXxx and ProtocolXxx functions calls NdisIMAssociateMiniport to inform the NDIS library about its miniport driver 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 driver 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 driver 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

Target platform

Universal

Version

See NdisIMAssociateMiniport.

Header

Ndis.h (include Ndis.h)

Library

Ndis.lib

IRQL

PASSIVE_LEVEL

See also

DriverEntry of NDIS Miniport Drivers
DriverEntry of NDIS Protocol Drivers
NdisIMRegisterLayeredMiniport
NdisMInitializeWrapper
NdisRegisterProtocol

 

 

Send comments about this topic to Microsoft

Show:
© 2016 Microsoft