NdisIfAddIfStackEntry, fonction (ndis.h)

Article
02/26/2024

La fonction NdisIfAddIfStackEntry spécifie le classement de deux interfaces réseau dans la pile d’interfaces réseau NDIS.

Syntaxe

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

Paramètres

[in] HigherLayerIfIndex

Index d’interface réseau pour l’interface qui doit être plus élevée dans la table de pile d’interface.

[in] LowerLayerIfIndex

Index d’interface réseau de l’interface qui doit être inférieure dans la table de pile d’interface.

Valeur retournée

NdisIfAddIfStackEntry retourne l’une des valeurs de status suivantes :

Code de retour	Description
NDIS_STATUS_SUCCESS	L’opération s’est terminée avec succès.
NDIS_STATUS_RESOURCES	L’opération a échoué en raison de ressources insuffisantes.
NDIS_STATUS_INTERFACE_NOT_FOUND	Échec de NdisIfAddIfStackEntry , car l’index à HigherLayerIfIndex ou LowerLayerIfIndex n’est pas l’index d’une interface inscrite.

Remarques

Les pilotes NDIS peuvent appeler la fonction NdisIfAddIfStackEntry pour spécifier l’ordre de deux interfaces réseau dans la pile d’interfaces NDIS. Le fournisseur de proxy NDIS spécifie l’ordre des modules de filtre et des adaptateurs miniport. NDIS spécifie également la relation entre le miniport virtuel et l’adaptateur miniport sous-jacent pour les pilotes intermédiaires de filtre. Toutefois, NDIS ne spécifie pas l’ordre de pile pour les pilotes intermédiaires MUX.

NDIS gère une table de pile d’interface (ifStackTable à partir de la RFC 2863). NDIS fournit NdisIfAddIfStackEntry et Les fonctions NdisIfDeleteIfStackEntry pour ajouter et supprimer des entrées dans cette table.

Tout pilote qui peut fournir les informations sur la relation d’ordre de pile entre deux interfaces doit appeler NdisIfAddIfStackEntry pour remplir la table de pile d’interface. NDIS supprime les entrées de pile correspondantes pour une interface lors de l’annulation de l’inscription de l’interface.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge dans NDIS 6.0 et versions ultérieures.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	ndis.h (inclure Ndis.h)
Bibliothèque	Ndis.lib
IRQL	PASSIVE_LEVEL
Règles de conformité DDI	Irql_Interfaces_Function(ndis)

Voir aussi

NdisIfDeleteIfStackEntry

Partager via