NdisIMDeInitializeDeviceInstance
NdisIMDeInitializeDeviceInstance calls an NDIS intermediate driver's MiniportHalt function 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
NdisIMDeInitializeDeviceInstance returns NDIS_STATUS_SUCCESS if the network adapter has been torn down. Otherwise, it can return NDIS_STATUS_FAILURE if the given NdisMiniportHandle is invalid.
Comments
For NDIS intermediate drivers, NdisIMDeInitializeDeviceInstance is the reciprocal of NdisIMInitializeDeviceInstance. Such a driver usually calls NdisIMDeInitializeDeviceInstance from its ProtocolUnbindAdapter function, 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 NdisIMDeInitializeDeviceInstance causes a call to the intermediate driver's MiniportHalt function 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
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.