NdisIMDeInitializeDeviceInstance (Compact 2013)
3/26/2014
This function calls an NDIS intermediate driver's MiniportHalt function to tear down the driver's virtual miniport.
Syntax
NDIS_STATUS
NdisIMDeInitializeDeviceInstance(
NDIS_HANDLE NdisMiniportHandle
);
Parameters
- NdisMiniportHandle
[in] The handle that NDIS supplied to the MiniportInitializeEx function.
Return Value
Value |
Description |
|---|---|
NDIS_STATUS_SUCCESS |
If the network adapter has been torn down. |
NDIS_STATUS_FAILURE |
If the given NdisMiniportHandle is invalid. |
Remarks
For NDIS intermediate drivers, NdisIMDeInitializeDeviceInstance is the reciprocal of NdisIMInitializeDeviceInstanceEx. Such a driver usually calls NdisIMDeInitializeDeviceInstanceEx 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 MiniportHaltEx 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
Header |
ndis.h |
Library |
ndis.lib |
See Also
Reference
NDIS Functions for Intermediate Drivers
MiniportInitialize
MiniportHalt
NdisIMInitializeDeviceInstance
NdisIMInitializeDeviceInstanceEx
ProtocolUnbindAdapter