Share via


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

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