Share via


NdisMCmCloseAddressFamilyComplete (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.

NdisMCmCloseAddressFamilyComplete returns the final status of a client's request, for which the MCM driver returned NDIS_STATUS_PENDING, to close the AF.

Syntax

VOID NdisMCmCloseAddressFamilyComplete(
  _In_ NDIS_STATUS Status,
  _In_ NDIS_HANDLE NdisAfHandle
);

Parameters

  • Status [in]
    The caller sets this to NDIS_STATUS_SUCCESS.

  • NdisAfHandle [in]
    Specifies the NDIS-supplied handle passed to the MCM driver's ProtocolCmOpenAf function when this client originally opened the address family.

Return value

None

Remarks

An MCM driver must call NdisMCmCloseAddressFamilyComplete if its ProtocolCmCloseAf function previously returned NDIS_STATUS_PENDING for the given NdisAfHandle. The client, which initiated the pended close-AF operation with a call to NdisClCloseAddressFamily, cannot release the resources it allocated to track communications on the AF until the MCM driver's call to NdisCmCloseAddressFamilyComplete.

A call to NdisMCmCloseAddressFamilyComplete causes NDIS to call the client's ProtocolClCloseAfComplete function.

The MCM driver cannot subsequently use the NdisAfHandle, which is invalid for the MCM driver when NdisMCmCloseAddressFamilyComplete returns control.

Only connection-oriented miniport drivers that provide integrated call-management support can call NdisMCmCloseAddressFamilyComplete. Stand-alone call managers, which register themselves with NDIS as protocols, call NdisCmCloseAddressFamilyComplete instead.

Requirements

Target platform

Desktop

Version

See NdisMCmOpenAddressFamilyComplete.

Header

Ndis.h (include Ndis.h)

IRQL

<= DISPATCH_LEVEL

See also

NdisClCloseAddressFamily

NdisCmCloseAddressFamilyComplete

ProtocolClCloseAfComplete

ProtocolCmCloseAf

ProtocolCmOpenAf

 

 

Send comments about this topic to Microsoft