NdisIfQueryBindingIfIndex-Funktion (ndis.h)

Artikel
02/07/2025

Die NdisIfQueryBindingIfIndex--Funktion ruft die Netzwerkschnittstellenindizes und NET_LUID Werte für die höchsten und niedrigsten Layer-Netzwerkschnittstellen ab, die einer angegebenen Protokollbindung zugeordnet sind.

Syntax

NDIS_STATUS NdisIfQueryBindingIfIndex(
  [in]  NDIS_HANDLE  NdisBindingHandle,
  [out] PNET_IFINDEX pBoundIfIndex,
  [out] PNET_LUID    pBoundIfNetLuid,
  [out] PNET_IFINDEX pLowestIfIndex,
  [out] PNET_LUID    pLowestIfNetLuid
);

Parameter

[in] NdisBindingHandle

Ein Handle, das die Bindung angibt, für die NDIS die NET_LUID Werte und Netzwerkschnittstellenindizes abrufen soll. NDIS hat dieses Handle an der NdisBindingHandle Parameter der funktion NdisOpenAdapterEx bereitgestellt.

[out] pBoundIfIndex

Ein Zeiger auf eine vom Aufrufer bereitgestellte Schnittstellenindexvariable. Wenn NdisIfQueryBindingIfIndex- erfolgreich ist, schreibt NDIS in diese Variable den Netzwerkschnittstellenindex der Netzwerkschnittstelle, die der angegebenen Bindung zugeordnet ist und am höchsten im Treiberstapel ist.

[out] pBoundIfNetLuid

Ein Zeiger auf eine vom Aufrufer bereitgestellte NET_LUID Variable. Wenn NdisIfQueryBindingIfIndex- erfolgreich ist, schreibt NDIS in diese Variable den NET_LUID Wert der Netzwerkschnittstelle, die der angegebenen Bindung zugeordnet ist und die höchste im Treiberstapel ist.

[out] pLowestIfIndex

Ein Zeiger auf eine vom Aufrufer bereitgestellte Schnittstellenindexvariable. Wenn NdisIfQueryBindingIfIndex erfolgreich ist, schreibt NDIS in diese Variable den Netzwerkschnittstellenindex der Netzwerkschnittstelle, die der angegebenen Bindung zugeordnet ist und am niedrigsten im Treiberstapel ist.

[out] pLowestIfNetLuid

Ein Zeiger auf eine vom Aufrufer bereitgestellte NET_LUID Variable. Wenn NdisIfQueryBindingIfIndex erfolgreich ist, schreibt NDIS in diese Variable den NET_LUID Wert der Netzwerkschnittstelle, die der angegebenen Bindung zugeordnet ist und am niedrigsten im Treiberstapel ist.

Rückgabewert

NdisIfQueryBindingIfIndex gibt einen der folgenden Statuswerte zurück:

Rückgabecode	Beschreibung
NDIS_STATUS_SUCCESS	Der Vorgang wurde erfolgreich abgeschlossen.
NDIS_STATUS_INTERFACE_NOT_FOUND	NdisIfQueryBindingIfIndex fehlgeschlagen, da die angegebene Bindung nicht einer registrierten Schnittstelle zugeordnet ist.

Bemerkungen

NDIS-Protokolltreiber können die NdisIfQueryBindingIfIndex- Funktion aufrufen, um die Netzwerkschnittstellenindizes und NET_LUID Werte abzurufen, die einer Bindung zugeordnet sind.

NdisIfQueryBindingIfIndex stellt den NET_LUID Wert und den Schnittstellenindex für die höchste Schnittstelle und die niedrigste Schnittstelle bereit, die der Bindung zugeordnet sind. Diese Werte unterscheiden sich beispielsweise, wenn der direkt mit der angegebenen Bindung verknüpfte Miniportadapter der virtuelle Miniport eines Filter zwischentreibers ist oder ein Filtermodul vorhanden ist, das über den Miniportadapter konfiguriert ist.

Protokolltreiber können auch den Schnittstellenindex und NET_LUID der höchsten und niedrigsten Schnittstellen in einem Treiberstapel in der NDIS_BIND_PARAMETERS-Struktur abrufen.

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)

Siehe auch

NDIS_BIND_PARAMETERS

NET_LUID

NdisOpenAdapterEx

Freigeben über