Microsoft Windows CE 3.0  

NdisIMDeInitializeDeviceInstance

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

NdisIMDeInitializeDeviceInstancecalls an NDIS intermediate driver's MiniportHaltfunction to tear down the driver's virtual network adapter.

NDIS_STATUS
NdisIMDeInitializeDeviceInstance(
IN NDIS_HANDLE
NdisMiniportHandle
);

Parameters

NdisMiniportHandle
Specifies the handle originally input to MiniportInitialize.

Return Values

NdisIMDeInitializeDeviceInstancereturns NDIS_STATUS_SUCCESS if the network adapter has been torn down. Otherwise, it can return NDIS_STATUS_FAILURE if the given NdisMiniportHandleis invalid.

Comments

For NDIS intermediate drivers, NdisIMDeInitializeDeviceInstanceis the reciprocal of NdisIMInitializeDeviceInstance. Such a driver usually calls NdisIMDeInitializeDeviceInstancefrom its ProtocolUnbindAdapterfunction, when the underlying network adapter to which it was bound is being removed from the system, possibly because it is being reconfigured.

The call to NdisIMDeInitializeDeviceInstancecauses a call to the intermediate driver's MiniportHaltfunction after NDIS has told all higher level protocols that had bound themselves to the intermediate's virtual network adapter that they must unbind.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 3.0 and later Ndis.h   Ndislib.lib
Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

MiniportHalt, MiniportInitialize, NdisIMInitializeDeviceInstance, ProtocolUnbindAdapter