OID_SWITCH_PORT_DELETE
Le bord 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 concernant la suppression d’un port de commutateur extensible.
Le InformationBuffer membre de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_SWITCH_PORT_PARAMETERS.
Remarques
Le portId membre 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, la périphérie du protocole suit ces étapes avant de supprimer le port :
La périphérie du protocole émet une demande de jeu OID de OID_SWITCH_NIC_DISCONNECT pour avertir l’extension que la connexion entre une carte réseau et le port de commutateur extensible est supprimée.
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 d’OID de OID_SWITCH_NIC_DELETE pour avertir l’extension que la connexion entre une carte réseau et le port de commutateur extensible a été supprimée.
À ce stade, la périphérie du protocole peut commencer à supprimer le port.
Le bord du protocole du commutateur extensible suit ces étapes quand il supprime un port de commutateur extensible :
Le bord du protocole du commutateur extensible émet une demande de jeu d’OID de OID_SWITCH_PORT_TEARDOWN. Cette demande OID notifie les extensions de commutateur extensible sous-jacentes au début du processus de suppression pour un port de commutateur extensible.
La périphérie du protocole émet une requête de jeu d’OID de OID_SWITCH_PORT_DELETE une fois que toutes les demandes OID sur le port de commutateur extensible ont été terminées.
Remarque 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 émet la demande de OID_SWITCH_NIC_DELETE.
L’extension doit suivre ces instructions pour gérer les requêtes de jeu d’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 d’OID aux extensions sous-jacentes. L’extension ne doit pas échouer la requête.
Une fois la demande OID_SWITCH_PORT_DELETE terminée avec NDIS_STATUS_SUCCESS, l’extension ne recevra pas de paquets ou de demandes OID pour le port supprimé. L’extension ne peut pas transférer les paquets vers le port supprimé. L’extension ne peut pas également émettre de requêtes OID ni appeler la fonction ReferenceSwitchPort pour le port supprimé.
Remarque extensions de commutateur extensible ne doivent pas émettre de demandes de jeu d’OID de OID_SWITCH_PORT_DELETE.
Pour plus d’informations sur les états des ports de commutateur extensible et des connexions de carte réseau, consultez Hyper-V ports de commutateur extensible et les états de carte réseau.
Codes d’état de retour
Le bord miniport sous-jacent du commutateur extensible termine la demande de jeu d’OID de OID_SWITCH_PORT_DELETE et retourne le code d’état suivant.
| Code d’état | Description |
|---|---|
NDIS_STATUS_SUCCESS |
La requête OID s’est terminée avec succès. |
Exigences
Version |
Prise en charge dans NDIS 6.30 et versions ultérieures. |
En-tête |
Ntddndis.h (include Ndis.h) |