NDIS_SWITCH_DEREFERENCE_SWITCH_NIC fonction de rappel (ndis.h)

  • Article

La fonction DereferenceSwitchNic décrémente le compteur de référence de commutateur extensible Hyper-V pour une carte réseau connectée à un port de commutateur extensible. Le compteur de références a été incrémenté via un appel précédent à ReferenceSwitchNic.

Syntaxe

NDIS_SWITCH_DEREFERENCE_SWITCH_NIC NdisSwitchDereferenceSwitchNic;

NDIS_STATUS NdisSwitchDereferenceSwitchNic(
  [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.

Valeur retournée

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

Remarques

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

L’extension doit appeler DereferenceSwitchNic si elle avait précédemment appelé ReferenceSwitchNic pour une connexion de carte réseau.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Pris en charge dans NDIS 6.30 et versions ultérieures.
Plateforme cible Desktop (Expérience utilisateur)
En-tête ndis.h (inclure Ndis.h)
IRQL <= DISPATCH_LEVEL

Voir aussi

NdisFGetOptionalSwitchHandlers

OID_SWITCH_NIC_DELETE

ReferenceSwitchNic