NdisIfGetInterfaceIndexFromNetLuid-Funktion (ndis.h)

Artikel
02/07/2025

Die NdisIfGetInterfaceIndexFromNetLuid Funktion ruft den Netzwerkschnittstellenindex ab, der einem NET_LUID-Wert zugeordnet ist.

Syntax

NDIS_STATUS NdisIfGetInterfaceIndexFromNetLuid(
  [in]  NET_LUID     NetLuid,
  [out] PNET_IFINDEX pIfIndex
);

Parameter

[in] NetLuid

Ein NET_LUID Wert, der eine Netzwerkschnittstelle identifiziert.

[out] pIfIndex

Ein Zeiger auf eine vom Aufrufer bereitgestellte Schnittstellenindexvariable. Wenn NdisGetInterfaceIndexFromNetLuid erfolgreich ist, schreibt NDIS den Netzwerkschnittstellenindex, der der angegebenen NET_LUID dieser Variablen zugeordnet ist.

Rückgabewert

NdisIfGetInterfaceIndexFromNetLuid gibt einen der folgenden Statuswerte zurück:

Rückgabecode	Beschreibung
NDIS_STATUS_SUCCESS	Der Vorgang wurde erfolgreich abgeschlossen.
NDIS_STATUS_INTERFACE_NOT_FOUND	NdisIfGetInterfaceIndexFromNetLuid fehlgeschlagen, da die angegebene NET_LUID in der Liste der registrierten Schnittstellen nicht vorhanden war.

Bemerkungen

NDIS-Treiber können die NdisGetInterfaceIndexFromNetLuid--Funktion aufrufen, um den Netzwerkschnittstellenindex abzurufen, der einem NET_LUID-Wert zugeordnet ist.

Für die Schnittstellen, die der NDIS-Proxyanbieterdienst verwaltet, stellt NDIS den Schnittstellenindex und NET_LUID in verschiedenen Treiberinitialisierungsstrukturen bereit:

Miniporttreiber können den Schnittstellenindex und NET_LUID für einen Miniportadapter im NDIS_MINIPORT_INIT_PARAMETERS Struktur.
Filtertreiber können den Schnittstellenindex und NET_LUID für ein Filtermodul im NDIS_FILTER_ATTACH_PARAMETERS Struktur.
Protokolltreiber können den Schnittstellenindex und NET_LUID der höchsten und der niedrigsten Schnittstellen in einem Treiberstapel in der NDIS_BIND_PARAMETERS-Struktur abrufen.

NDIS weist einer Netzwerkschnittstelle einen Schnittstellenindex zu, wenn der Schnittstellenanbieter die NdisIfRegisterInterface--Funktion aufruft. Ein Schnittstellenanbieter ruft das NDIS_MAKE_NET_LUID Makro auf, um den NET_LUID Wert zu erstellen, bevor eine Schnittstelle registriert wird.

Der Schnittstellenindexwert kann sich ändern, ohne dass ein Computer neu gestartet wird. Das Deregistern und erneute Registrieren einer Schnittstelle, die einem NET_LUID Wert zugeordnet ist, kann zu unterschiedlichen Schnittstellenindexwerten führen. Verwechseln Sie den Schnittstellenindex nicht mit dem NET_LUID Index, der nach einem Neustart eines Computers beibehalten wird.

NDIS stellt die NdisGetNetLuidFromInterfaceIndex Funktion, um den NET_LUID Wert abzurufen, der einem angegebenen Schnittstellenindex zugeordnet ist.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Unterstützt in NDIS 6.0 und höher.
Zielplattform-	Desktop
Header-	ndis.h (include Ndis.h)
Library	Ndis.lib
IRQL-	PASSIVE_LEVEL
DDI-Complianceregeln	Irql_Interfaces_Function(ndis)