OID_SWITCH_NIC_DELETE

Article
06/15/2023

Le bord du protocole du commutateur extensible Hyper-V émet une demande de jeu d’identificateur d’objet (OID) de OID_SWITCH_NIC_DELETE à la pile de pilotes de commutateur extensible. Cette demande OID informe les extensions de commutateur extensible sous-jacentes de la suppression d’une connexion entre un port de commutateur extensible et une carte réseau. La périphérie du protocole du commutateur extensible a précédemment averti les extensions que cette connexion est supprimée lorsqu’il a émis une demande de jeu OID de OID_SWITCH_NIC_DISCONNECT.

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

Notes

Le membre PortId de la structure NDIS_SWITCH_NIC_PARAMETERS spécifie le port pour lequel la notification de suppression est effectuée. L’extension de commutateur extensible peut obtenir les informations de paramètre pour ce port et d’autres ports sur le commutateur extensible en émettant des requêtes OID de OID_SWITCH_PORT_ARRAY.

Le membre Index de la structure NDIS_SWITCH_NIC_PARAMETERS spécifie l’index d’une carte réseau pour laquelle la notification de suppression est effectuée. La carte réseau avec la valeur d’index spécifiée est connectée au port de commutateur extensible spécifié par le membre PortId . Pour plus d’informations sur ces valeurs d’index, consultez Valeurs d’index de carte réseau.

Avant que le bord du protocole du commutateur extensible n’envoie la demande de OID_SWITCH_NIC_DELETE, il garantit que toutes les demandes de paquets en attente d’envoi ou de réception pour la connexion de la carte réseau spécifiée ont été effectuées. La périphérie du protocole garantit également que toutes les demandes OID en attente pour la connexion de l’adaptateur ont été effectuées et que les compteurs de référence de commutateur extensible pour la connexion de l’adaptateur ont une valeur nulle.

Note Si l’extension a incrémenté un compteur de référence de commutateur extensible pour la carte réseau en appelant ReferenceSwitchNic, la demande de OID_SWITCH_NIC_DELETE n’est pas émise alors que le compteur de référence n’est pas nul. L’extension décrémente le compteur de référence du commutateur extensible en appelant DereferenceSwitchNic.

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

L’extension ne doit pas modifier la structure NDIS_SWITCH_NIC_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 terminer la demande.
L’extension ne doit pas émettre ses propres requêtes de jeu OID de OID_SWITCH_NIC_DELETE.
La carte réseau externe de commutateur extensible peut être liée à une ou plusieurs cartes physiques sous-jacentes. Pour chaque carte réseau physique liée à la carte réseau externe, la périphérie du protocole du commutateur extensible émet une demande de jeu OID distincte de OID_SWITCH_NIC_DELETE. Chaque demande de jeu OID spécifie une valeur d’index de connexion de carte réseau différente. Pour plus d’informations sur ces valeurs d’index, consultez Valeurs d’index de carte réseau.

L’extension doit conserver l’état de connexion pour chaque carte physique sous-jacente. Pour plus d’informations sur les différentes configurations dans lesquelles les cartes réseau physiques peuvent être liées à la carte réseau externe, consultez Types de configurations de cartes réseau physiques.

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.