Partager via


NDIS_SWITCH_DEREFERENCE_SWITCH_NIC fonction de rappel (ndis.h)

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érence 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 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 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 de commutateur extensible 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.

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

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

Voir aussi

NdisFGetOptionalSwitchHandlers

OID_SWITCH_NIC_DELETE

ReferenceSwitchNic