NdisCloseAdapter

This function releases the binding established and the resources allocated when the protocol called the NdisOpenAdapter function.

VOID NdisCloseAdapter(
  PNDIS_STATUS Status,
  NDIS_HANDLE NdisBindingHandle
);

Parameters

  • Status
    [out] Pointer to a caller-supplied variable in which this function returns the status of the close operation.
  • NdisBindingHandle
    [in] Handle returned by NdisOpenAdapter that identifies the virtual adapter or NIC to be closed.

Return Values

The following table shows the values returned from NdisCloseAdapter.

Value Description
NDIS_STATUS_SUCCESS The binding is closed, and all resources pertaining to that binding have been released.
NDIS_STATUS_PENDING A close-adapter request is being handled asynchronously, and the caller's ProtocolCloseAdapterComplete function will be called when the close operation is done.

Remarks

Unlike Microsoft® Windows NT®, Windows CE does not unload the miniport driver when there are no more protocol drivers (also known as protocol stacks) bound to it.

As soon as a protocol calls this function, the caller should consider the handle at NdisBindingHandle invalid.

Requirements

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

See Also

NdisDeregisterProtocol | NdisOpenAdapter | ProtocolCloseAdapterComplete | ProtocolStatus

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.