NdisIfDeregisterInterface function (ndis.h)

The NdisIfDeregisterInterface function deregisters an NDIS network interface that was previously registered by a call to the NdisIfRegisterInterface function.

Syntax

void NdisIfDeregisterInterface(
  NET_IFINDEX ifIndex
);

Parameters

ifIndex

An index that identifies the network interface to deregister. The interface provider obtained this index from a previous call to the NdisIfRegisterInterface function.

Return value

None

Remarks

NDIS interface providers call the NdisIfDeregisterInterface function to deregister a network interface and to indicate that the interface should be removed from the list of known interfaces on the computer.

An interface provider calls the NdisIfDeregisterInterface function, for example, because the interface has been uninstalled. Interface providers do not call NdisIfDeregisterInterface to indicate that an interface has changed state.

NdisIfDeregisterInterface releases the interface index, so NDIS can reassign the index to another interface that is registered later. Do not confuse the interface index with the NET_LUID index, which persists after a computer restarts.

Requirements

Requirement Value
Minimum supported client Supported in NDIS 6.0 and later.
Target Platform Desktop
Header ndis.h (include Ndis.h)
Library Ndis.lib
IRQL PASSIVE_LEVEL
DDI compliance rules Irql_Interfaces_Function(ndis)

See also

NET_LUID

NdisIfRegisterInterface