NdisIfAddIfStackEntry-Funktion (ndis.h)

  • Artikel

Die NdisIfAddIfStackEntry-Funktion gibt die Reihenfolge von zwei Netzwerkschnittstellen im NDIS-Netzwerkschnittstellenstapel an.

Syntax

NDIS_STATUS NdisIfAddIfStackEntry(
  [in] NET_IFINDEX HigherLayerIfIndex,
  [in] NET_IFINDEX LowerLayerIfIndex
);

Parameter

[in] HigherLayerIfIndex

Der Netzwerkschnittstellenindex für die Schnittstelle, die in der Schnittstellenstapeltabelle höher sein sollte.

[in] LowerLayerIfIndex

Der Netzwerkschnittstellenindex für die Schnittstelle, die in der Schnittstellenstapeltabelle niedriger sein sollte.

Rückgabewert

NdisIfAddIfStackEntry gibt einen der folgenden status Werte zurück:

Rückgabecode Beschreibung
NDIS_STATUS_SUCCESS
 Der Vorgang wurde erfolgreich abgeschlossen.
NDIS_STATUS_RESOURCES
 Der Vorgang ist aufgrund unzureichender Ressourcen fehlgeschlagen.
NDIS_STATUS_INTERFACE_NOT_FOUND
 Fehler bei NdisIfAddIfStackEntry , da der Index bei HigherLayerIfIndex oder LowerLayerIfIndex nicht der Index einer registrierten Schnittstelle ist.

Hinweise

NDIS-Treiber können die NdisIfAddIfStackEntry-Funktion aufrufen, um die Reihenfolge von zwei Netzwerkschnittstellen im NDIS-Schnittstellenstapel anzugeben. Der NDIS-Proxyanbieter gibt die Reihenfolge für Filtermodule und Miniportadapter an. NDIS gibt auch die Beziehung zwischen dem virtuellen Miniport und dem zugrunde liegenden Miniportadapter für Filterzwischentreiber an. NDIS gibt jedoch nicht die Stapelreihenfolge für MUX-Zwischentreiber an.

NDIS verwaltet eine Schnittstellenstapeltabelle (ifStackTable aus RFC 2863). NDIS stellt die NdisIfAddIfStackEntry und NdisIfDeleteIfStackEntry-Funktionen zum Hinzufügen und Löschen von Einträgen in dieser Tabelle.

Jeder Treiber, der Informationen zur Stapelreihenfolgenbeziehung zwischen zwei Schnittstellen bereitstellen kann, sollte NdisIfAddIfStackEntry aufrufen, um die Schnittstellenstapeltabelle aufzufüllen. NDIS löscht die entsprechenden Stapeleinträge für eine Schnittstelle, wenn die Registrierung der Schnittstelle aufgehoben wird.

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

NdisIfDeleteIfStackEntry