NdisIfDeregisterInterface function (ndis.h)

Article
02/22/2024

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)

Share via