OID_SWITCH_NIC_DISCONNECT

Article
06/15/2023

Le bord du protocole du commutateur extensible Hyper-V émet une demande d’ensemble d’identificateur d’objet (OID) de OID_SWITCH_NIC_DISCONNECT pour notifier les extensions de commutateur extensible sous-jacentes qu’une connexion entre un port de commutateur extensible et une carte réseau est en cours d’arrêt. Une fois la connexion complètement interrompue, le bord du protocole du commutateur extensible émet une demande de jeu d’OID de OID_SWITCH_NIC_DELETE.

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

Notes

Le membre Index de la structure NDIS_SWITCH_NIC_PARAMETERS spécifie l’index d’une carte réseau pour laquelle la notification de déconnexion 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.

L’extension doit suivre ces instructions lorsqu’elle gère les demandes de jeu d’OID de OID_SWITCH_NIC_DISCONNECT :

L’extension ne doit pas modifier la structure NDIS_SWITCH_NIC_PARAMETERS associée à la requête OID.
La demande OID_SWITCH_NIC_DISCONNECT avertit uniquement l’extension que la connexion de commutateur extensible est en cours d’arrêt entre la carte réseau spécifiée et le port de commutateur extensible. Une fois que l’extension a géré cette requête OID, elle ne doit pas effectuer les opérations suivantes :
- Générez tout trafic de paquets vers la connexion de carte réseau sur le port de commutateur extensible pour lequel la demande OID OID_SWITCH_NIC_DISCONNECT a été émise.
- Appelez ReferenceSwitchNic pour incrémenter le compteur de référence de commutateur extensible pour la connexion de carte réseau spécifiée sur le port du commutateur extensible.
- Transférer ou créer des requêtes OID de OID_SWITCH_NIC_REQUEST à une carte réseau sous-jacente pour laquelle la demande OID OID_SWITCH_NIC_DISCONNECT a été émise.
  
  Note Si l’extension appelée ReferenceSwitchNic pour incrémenter le compteur de référence de commutateur extensible avant l’émission du OID_SWITCH_NIC_DISCONNECT, l’extension peut toujours transférer ou provenir des requêtes OID.
- Transférer ou créer NDIS status indications de NDIS_STATUS_SWITCH_NIC_STATUS à partir d’une carte réseau sous-jacente pour laquelle la demande d’OID OID_SWITCH_NIC_DISCONNECT a été émise.
  
  Note Si l’extension appelée ReferenceSwitchNic pour incrémenter le compteur de référence de commutateur extensible avant l’émission du OID_SWITCH_NIC_DISCONNECT, l’extension peut toujours transférer ou provenir d’indications NDIS status.
  
  Note Si l’extension précédemment appelée ReferenceSwitchNic pour incrémenter le compteur de référence de commutateur extensible, elle n’a pas besoin de synchroniser ses appels pour créer ou transférer des requêtes OID ou des indications NDIS status avec son code qui gère les requêtes OID de commutateur extensible Hyper-V. Une fois que l’extension incrémente le compteur de référence, l’interface de commutateur extensible n’émet pas de demande de jeu d’OID de OID_SWITCH_NIC_DELETE.
L’extension doit toujours transférer cette demande de jeu d’OID aux extensions sous-jacentes. L’extension ne doit pas terminer la demande.
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 d’OID distincte de OID_SWITCH_NIC_DISCONNECT. Chaque demande de jeu d’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 carte réseau physique.

Note L’extension ne doit pas émettre ses propres demandes de jeu d’OID de OID_SWITCH_NIC_DISCONNECT.

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

Codes d’état de retour

Le bord miniport sous-jacent du commutateur extensible termine la requête de requête OID de OID_SWITCH_NIC_DISCONNECT et retourne le code status suivant.