Freigeben über


NdisIfGetNetLuidFromInterfaceIndex-Funktion (ndis.h)

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:

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)

Weitere Informationen

NDIS_BIND_PARAMETERS

NDIS_FILTER_ATTACH_PARAMETERS

NDIS_MAKE_NET_LUID

NDIS_MINIPORT_INIT_PARAMETERS

NET_LUID

NdisIfGetInterfaceIndexFromNetLuid

NdisIfRegisterInterface