NdisIfGetInterfaceIndexFromNetLuid-Funktion (ndis.h)

Artikel
08/07/2023

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 NdisIfGetInterfaceIndexFromNetLuid erfolgreich ist, schreibt NDIS den Netzwerkschnittstellenindex, der dem angegebenen NET_LUID dieser Variablen zugeordnet ist.

Rückgabewert

NdisIfGetInterfaceIndexFromNetLuid gibt einen der folgenden status Werte zurück:

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

Hinweise

NDIS-Treiber können die Funktion NdisIfGetInterfaceIndexFromNetLuid 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 niedrigsten Schnittstellen auf einem Treiberstapel in der NDIS_BIND_PARAMETERS-Struktur abrufen.

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

Der Wert des Schnittstellenindexes kann sich ohne Neustart des Computers ändern. Das Aufheben der Registrierung und erneuten Registrierung 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 dem Neustart eines Computers beibehalten wird.

NDIS stellt die NdisIfGetNetLuidFromInterfaceIndex-Funktion zum Abrufen des NET_LUID Werts, der einem angegebenen Schnittstellenindex zugeordnet ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.0 und höher.
Zielplattform	Desktop
Kopfzeile	ndis.h (einschließlich Ndis.h)
Bibliothek	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	Irql_Interfaces_Function(ndis)