NdisIfGetNetLuidFromInterfaceIndex-Funktion (ndis.h)

Artikel
02/07/2025

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

Syntax

NDIS_STATUS NdisIfGetNetLuidFromInterfaceIndex(
        NET_IFINDEX ifIndex,
  [out] PNET_LUID   pNetLuid
);

Parameter

ifIndex

Ein Netzwerkschnittstellenindex, der NDIS einem NET_LUID Wert im NdisIfRegisterInterface Funktion.

[out] pNetLuid

Ein Zeiger auf eine vom Aufrufer bereitgestellte NET_LUID Variable. Wenn NdisGetNetLuidFromInterfaceIndex erfolgreich ist, schreibt NDIS den NET_LUID Wert, der dem angegebenen Netzwerkschnittstellenindex zugeordnet ist, auf diese Variable.

Rückgabewert

NdisGetNetLuidFromInterfaceIndex gibt einen der folgenden Statuswerte zurück:

Rückgabecode	Beschreibung
NDIS_STATUS_SUCCESS	Der Vorgang wurde erfolgreich abgeschlossen.
NDIS_STATUS_INTERFACE_NOT_FOUND	NdisGetNetLuidFromInterfaceIndex fehlgeschlagen, da der angegebene Netzwerkschnittstellenindex nicht einer registrierten Schnittstelle zugewiesen ist.

Bemerkungen

NDIS-Treiber können die NdisGetGetNetLuidFromInterfaceIndex- Funktion aufrufen, um den NET_LUID Wert abzurufen, der einem Netzwerkschnittstellenindex 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 unteren 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 NdisIfGetInterfaceIndexFromNetLuid Funktion, um den Schnittstellenindex für eine angegebene NET_LUID abzurufen.

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)