OID_SWITCH_PORT_DELETE

Article
06/15/2023

La périphérie du protocole du commutateur extensible Hyper-V émet une demande de jeu d’identificateur d’objet (OID) de OID_SWITCH_PORT_DELETE pour notifier les extensions de commutateur extensibles de la suppression d’un port de commutateur extensible.

Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_SWITCH_PORT_PARAMETERS .

Notes

Le membre PortId de la structure NDIS_SWITCH_PORT_PARAMETERS spécifie le port de commutateur extensible pour lequel la notification de suppression est effectuée.

Si une carte réseau est connectée au port spécifié, le bord du protocole du commutateur extensible supprime la connexion avant de supprimer le port. Dans ce cas, l’arête du protocole suit les étapes suivantes avant de supprimer le port :

La périphérie du protocole émet une demande de jeu OID de OID_SWITCH_NIC_DISCONNECT pour informer l’extension que la connexion entre une carte réseau et le port de commutateur extensible est en cours de suppression.
Une fois que tous les paquets en attente pour le port de commutateur extensible spécifié ont été annulés ou terminés, la périphérie du protocole émet une demande de jeu OID de OID_SWITCH_NIC_DELETE pour notifier l’extension que la connexion entre une carte réseau et le port de commutateur extensible a été supprimée.

À ce stade, le bord du protocole peut commencer à supprimer le port.

Le bord du protocole du commutateur extensible suit les étapes suivantes lorsqu’il supprime un port de commutateur extensible :

Le bord du protocole du commutateur extensible émet une demande d’ensemble OID de OID_SWITCH_PORT_TEARDOWN. Cette demande OID informe les extensions de commutateur extensible sous-jacentes du début du processus de suppression d’un port de commutateur extensible.
La périphérie du protocole émet une demande d’ensemble OID de OID_SWITCH_PORT_DELETE une fois que toutes les demandes OID adressées au port de commutateur extensible sont terminées.

Note Si l’extension avait précédemment appelé ReferenceSwitchPort pour incrémenter le compteur de référence du port, elle doit appeler DereferenceSwitchPort avant que la périphérie du protocole n’émet la demande de OID_SWITCH_NIC_DELETE .

L’extension doit suivre ces instructions pour gérer les demandes de jeu OID de OID_SWITCH_PORT_DELETE :

L’extension ne doit pas modifier la structure NDIS_SWITCH_PORT_PARAMETERS associée à la requête OID.
L’extension doit toujours transférer cette demande de jeu OID aux extensions sous-jacentes. L’extension ne doit pas échouer la demande.
Une fois la demande de OID_SWITCH_PORT_DELETE terminée avec NDIS_STATUS_SUCCESS, l’extension ne reçoit pas de paquets ou de requêtes OID pour le port supprimé. L’extension ne peut pas transférer les paquets vers le port supprimé. L’extension ne peut pas non plus émettre de requêtes OID ni appeler la fonction ReferenceSwitchPort pour le port supprimé.

Note Les extensions de commutateur extensible ne doivent pas émettre de demandes de jeu OID de OID_SWITCH_PORT_DELETE.

Pour plus d’informations sur les états des ports de commutateur extensibles et des connexions de carte réseau, consultez Ports de commutateur extensible Hyper-V et États de la carte réseau.

Codes d’état de retour

Le bord miniport sous-jacent du commutateur extensible termine la demande d’ensemble OID de OID_SWITCH_PORT_DELETE et retourne le code status suivant.