NdisCloseAdapter (Windows Embedded CE 6.0)

  • Article

1/6/2010

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

Syntax

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 Value

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 Embedded 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

Header ndis.h
Library ndis.lib
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

NDIS Library Functions
NdisDeregisterProtocol
NdisOpenAdapter
ProtocolCloseAdapterComplete
ProtocolStatus