NdisIMDeInitializeDeviceInstance (Windows Embedded CE 6.0)
1/6/2010
This function calls an NDIS intermediate driver's MiniportHalt function to tear down the driver's virtual NIC.
Syntax
NDIS_STATUS NdisIMDeInitializeDeviceInstance(
NDIS_HANDLE NdisMiniportHandle
);
Parameters
- NdisMiniportHandle
[in] Specifies the handle originally input to MiniportInitialize.
Return Value
| Value | Description |
|---|---|
NDIS_STATUS_SUCCESS |
If the NIC 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 NIC 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 NIC that they must unbind.
Requirements
| Header | ndis.h |
| Library | ndis.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
See Also
Reference
NDIS Library Functions
MiniportInitialize
MiniportHalt
NdisIMInitializeDeviceInstance
NdisIMInitializeDeviceInstanceEx
ProtocolUnbindAdapter