Compartir a través de


NdisIMDeInitializeDeviceInstance (NDIS 5.1) function

Note   NDIS 5. x has been deprecated and is superseded by NDIS 6. x. For new NDIS driver development, see Network Drivers Starting with Windows Vista. For information about porting NDIS 5. x drivers to NDIS 6. x, see Porting NDIS 5.x Drivers to NDIS 6.0.

NdisIMDeInitializeDeviceInstance calls an NDIS intermediate driver's MiniportHalt function to tear down the driver's virtual NIC.

Syntax

NDIS_STATUS NdisIMDeInitializeDeviceInstance(
  _In_ NDIS_HANDLE NdisMiniportHandle
);

Parameters

Return value

NdisIMDeInitializeDeviceInstance returns NDIS_STATUS_SUCCESS if the NIC has been torn down. Otherwise, it can return NDIS_STATUS_FAILURE if the given NdisMiniportHandle is invalid.

Remarks

For NDIS intermediate drivers, NdisIMDeInitializeDeviceInstance is the reciprocal of the NdisIMInitializeDeviceInstance or NdisIMInitializeDeviceInstanceEx function. Such a driver usually calls NdisIMDeInitializeDeviceInstance 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

Target platform

Universal

Version

See NdisIMDeInitializeDeviceInstance.

Header

Ndis.h (include Ndis.h)

Library

Ndis.lib

IRQL

PASSIVE_LEVEL

See also

MiniportHalt

NdisIMInitializeDeviceInstance

NdisIMInitializeDeviceInstanceEx

ProtocolUnbindAdapter

 

 

Send comments about this topic to Microsoft