NdisIfGetNetLuidFromInterfaceIndex-Funktion (ndis.h)

Artikel
08/07/2023

Die NdisIfGetNetLuidFromInterfaceIndex-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, den NDIS einem NET_LUID-Wert im zugewiesen hat. NdisIfRegisterInterface-Funktion .

[out] pNetLuid

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

Rückgabewert

NdisIfGetNetLuidFromInterfaceIndex 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 NdisIfGetNetLuidFromInterfaceIndex , da der angegebene Netzwerkschnittstellenindex keiner registrierten Schnittstelle zugewiesen ist.

Hinweise

NDIS-Treiber können die NdisIfGetNetLuidFromInterfaceIndex-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:

Miniport-Treiber können den Schnittstellenindex und die NET_LUID für einen Miniportadapter in der NDIS_MINIPORT_INIT_PARAMETERS Struktur.
Filtertreiber können den Schnittstellenindex und die NET_LUID für ein Filtermodul im NDIS_FILTER_ATTACH_PARAMETERS Struktur.
Protokolltreiber können den Schnittstellenindex und die NET_LUID der höchsten und 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 makro NDIS_MAKE_NET_LUID auf, um den NET_LUID-Wert zu erstellen, bevor er eine Schnittstelle registriert.

Der Wert des Schnittstellenindex kann sich ändern, ohne dass der Computer neu gestartet wird. 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 NdisIfGetInterfaceIndexFromNetLuid-Funktion zum Abrufen des Schnittstellenindexes für eine angegebene NET_LUID.

Anforderungen

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