NdisIfAddIfStackEntry-Funktion (ndis.h)

Artikel
08/07/2023

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

Freigeben über