NDIS_SWITCH_REFERENCE_SWITCH_NIC fonction de rappel (ndis.h)

Article
02/07/2025

La fonction ReferenceSwitchNic incrémente le compteur de référence de commutateur extensible Hyper-V pour une carte réseau connectée à un port de commutateur extensible.

Syntaxe

NDIS_SWITCH_REFERENCE_SWITCH_NIC NdisSwitchReferenceSwitchNic;

NDIS_STATUS NdisSwitchReferenceSwitchNic(
  [in] NDIS_SWITCH_CONTEXT NdisSwitchContext,
  [in] NDIS_SWITCH_PORT_ID SwitchPortId,
  [in] NDIS_SWITCH_NIC_INDEX SwitchNicIndex
)
{...}

Paramètres

[in] NdisSwitchContext

Valeur NDIS_SWITCH_CONTEXT qui contient le handle du module de commutateur extensible auquel l’extension de commutateur extensible Hyper-V est attachée. Lorsque l’extension appelle NdisFGetOptionalSwitchHandlers, ce handle est retourné via le paramètre NdisSwitchContext.

[in] SwitchPortId

Valeur NDIS_SWITCH_PORT_ID qui contient l’identificateur unique du port de commutateur extensible auquel la carte réseau virtuelle est connectée.

[in] SwitchNicIndex

Valeur NDIS_SWITCH_NIC_INDEX qui spécifie l’index de la carte réseau virtuelle pour laquelle le compteur de référence de commutateur extensible doit être incrémenté.

Pour plus d’informations sur les valeurs NDIS_SWITCH_NIC_INDEX, consultez valeurs d’index de carte réseau.

Remarque Ce paramètre doit spécifier la valeur d’index d’une carte réseau dans un état connecté. Les valeurs d’index des cartes réseau qui se trouvent dans un état créé ou déconnecté ne peuvent pas être spécifiées. Pour plus d’informations sur les états de connexion réseau, consultez Hyper-V ports de commutateur extensible et les états de carte réseau.

Valeur de retour

Si l’appel réussit, la fonction retourne NDIS_STATUS_SUCCESS. Sinon, elle retourne un code d’erreur NDIS_STATUS_Xxx défini dans Ndis.h.

Remarques

L’extension de commutateur extensible appelle ReferenceSwitchNic pour incrémenter un compteur de référence pour une carte réseau connectée à un port de commutateur extensible. Bien que le compteur de référence ait une valeur différente de zéro, le bord du protocole du commutateur extensible n’émet pas de demande de jeu d’identificateur d’objet (OID) de OID_SWITCH_NIC_DELETE pour supprimer la connexion à l’adaptateur.

Une fois l’extension appelée ReferenceSwitchNic, elle doit appeler DereferenceSwitchNic pour décrémenter le compteur de référence de commutateur extensible.

L’extension doit appeler ReferenceSwitchNic avant d’effectuer les opérations suivantes :

Transfère une requête OID OID_SWITCH_NIC_REQUEST sur le chemin de contrôle de commutateur extensible vers une carte réseau physique sous-jacente.
Pour plus d’informations, consultez Gestion des requêtes OID sur des cartes réseau physiques.
Transfère une indication d’état NDIS_STATUS_SWITCH_NIC_STATUS sur le chemin de contrôle de commutateur extensible à partir d’une carte externe sous-jacente.
Pour plus d’informations, consultez Gestion des indications d’état NDIS à partir de cartes réseau physiques.

Remarque L’extension ne doit pas appeler ReferenceSwitchNic lors du transfert de paquets sur le chemin de données de commutateur extensible. L’interface de commutateur extensible gère ses propres compteurs de référence pour les paquets qui sont transférés aux ports et aux connexions de carte réseau via le chemin d’accès aux données.

L’extension appelle ReferenceSwitchNic une fois que la connexion de carte réseau a atteint l'connexion de carte réseau créée'état. L’extension ne doit pas appeler ReferenceSwitchNic une fois la connexion atteinte à la carte réseau déconnectée ou carte réseau supprimée états. Pour plus d’informations sur ces états, consultez Hyper-V ports de commutateur extensible et les états de carte réseau.

Remarque Lorsque l’extension appelle ReferenceSwitchNic, il n’est pas obligé de synchroniser l’appel avec son code qui gère les requêtes OID. Par conséquent, il est possible que l’extension appelle ReferenceSwitchNic tandis que le bord du protocole du commutateur extensible émet une requête OID de OID_SWITCH_NIC_DISCONNECT. Toutefois, si l’appel à ReferenceSwitchNic est terminé avec NDIS_STATUS_SUCCESS, l’extension peut toujours transférer OID_SWITCH_NIC_REQUEST demande OID ou NDIS_STATUS_SWITCH_NIC_STATUS indications d’état après qu’elle gère la requête OID OID_SWITCH_NIC_DISCONNECT.

Exigences

Exigence	Valeur
client minimum pris en charge	Prise en charge dans NDIS 6.30 et versions ultérieures.
plateforme cible	Bureau
d’en-tête	ndis.h (include Ndis.h)
IRQL	<= DISPATCH_LEVEL