Partager via


NDIS_SWITCH_DEREFERENCE_SWITCH_PORT fonction de rappel (ndis.h)

La fonction DereferenceSwitchPort décrémente le compteur de référence de commutateur extensible Hyper-V pour un port de commutateur extensible. Le compteur de références a été incrémenté via un appel précédent à ReferenceSwitchPort.

Syntaxe

NDIS_SWITCH_DEREFERENCE_SWITCH_PORT NdisSwitchDereferenceSwitchPort;

NDIS_STATUS NdisSwitchDereferenceSwitchPort(
  [in] NDIS_SWITCH_CONTEXT NdisSwitchContext,
  [in] NDIS_SWITCH_PORT_ID SwitchPortId
)
{...}

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é par le biais du paramètre NdisSwitchContext .

[in] SwitchPortId

Valeur NDIS_SWITCH_PORT_ID qui contient l’identificateur unique du port de commutateur extensible pour lequel le compteur de référence de commutateur extensible est incrémenté.

Valeur retournée

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 DereferenceSwitchPort pour décrémenter le compteur de référence pour 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 de protocole du commutateur extensible n’émet pas de demande de jeu d’identificateur d’objet (OID) de OID_SWITCH_PORT_DELETE pour supprimer le port.

L’extension doit appeler DereferenceSwitchPort si elle avait précédemment appelé ReferenceSwitchPort pour un port de commutateur extensible.

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_PORT_DELETE

ReferenceSwitchPort