NdisIfQueryBindingIfIndex-Funktion (ndis.h)

Artikel
08/07/2023

Die NdisIfQueryBindingIfIndex-Funktion ruft die Netzwerkschnittstellenindizes und NET_LUID Werte für die höchsten und niedrigsten 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 am NdisBindingHandle-Parameter der NdisOpenAdapterEx-Funktion 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 im Treiberstapel am höchsten 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 im Treiberstapel am höchsten ist.

[out] pLowestIfIndex

[out] pLowestIfNetLuid

Rückgabewert

NdisIfQueryBindingIfIndex 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 NdisIfQueryBindingIfIndex , da die angegebene Bindung keiner registrierten Schnittstelle zugeordnet ist.

Hinweise

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 und niedrigste Schnittstelle bereit, die der Bindung zugeordnet sind. Diese Werte unterscheiden sich beispielsweise, wenn der Miniportadapter, der der angegebenen Bindung direkt zugeordnet ist, der virtuelle Miniport eines Filterzwerdertreibers ist oder wenn 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
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)

Weitere Informationen

NDIS_BIND_PARAMETERS

NET_LUID

NdisOpenAdapterEx

Freigeben über