NdisCmCloseAddressFamilyComplete (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.
NdisCmCloseAddressFamilyComplete returns the final status of a client's request, for which the CM's ProtocolCmCloseAf function returned NDIS_STATUS_PENDING, to close the AF.
Syntax
VOID NdisCmCloseAddressFamilyComplete(
_In_ NDIS_STATUS Status,
_In_ NDIS_HANDLE NdisAfHandle
);
Parameters
Status [in]
The call manager sets this to NDIS_STATUS_SUCCESS.NdisAfHandle [in]
Specifies the NDIS-supplied handle passed to the call manager's ProtocolCmOpenAf function when this client originally opened the address family.
Return value
None
Remarks
A stand-alone call manager must call NdisCmCloseAddressFamilyComplete 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 CM's call to NdisCmCloseAddressFamilyComplete causes a call to that client's ProtocolClCloseAfComplete function.
After a call to NdisCmCloseAddressFamilyComplete, the call manager cannot subsequently use the NdisAfHandle, which becomes invalid for the call manager as soon as this call occurs.
Only stand-alone call managers, which register themselves with NDIS as protocols, can call NdisCmCloseAddressFamilyComplete. Connection-oriented miniport drivers that provide integrated call-management support must call NdisMCmCloseAddressFamilyComplete instead.
Requirements
Target platform |
Universal |
Version |
|
Header |
Ndis.h (include Ndis.h) |
Library |
Ndis.lib |
IRQL |
<= DISPATCH_LEVEL |
See also
NdisMCmCloseAddressFamilyComplete