NdisIfQueryBindingIfIndex-Funktion (ndis.h)

  • Artikel

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

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 die niedrigste im Treiberstapel ist.

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