OID_SWITCH_NIC_DISCONNECT

Le bord du protocole du commutateur extensible Hyper-V émet une demande de jeu d’identificateur d’objet (OID) de OID_SWITCH_NIC_DISCONNECT pour avertir les extensions de commutateur extensible sous-jacentes qu’une connexion entre un port de commutateur extensible et une carte réseau est détruite. Une fois la connexion complètement détruite, 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.

Remarques

L’index membre 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 Index spécifiée est connectée au port de commutateur extensible spécifié par le PortId membre. 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 requête OID_SWITCH_NIC_DISCONNECT avertit uniquement l’extension que la connexion de commutateur extensible est détruite entre la carte réseau spécifiée et le port de commutateur extensible spécifiés. Une fois que l’extension gère 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 requête 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 de commutateur extensible.

  • Transférer ou provenir des requêtes OID de OID_SWITCH_NIC_REQUEST vers une carte réseau sous-jacente pour laquelle la demande OID OID_SWITCH_NIC_DISCONNECT a été émise.

    Remarque 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 provenir des indications d’état NDIS de NDIS_STATUS_SWITCH_NIC_STATUS à partir d’une carte réseau sous-jacente pour laquelle la demande OID OID_SWITCH_NIC_DISCONNECT a été émise.

    Remarque 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 indications d’état NDIS.

    Remarque Si l’extension précédemment appelée ReferenceSwitchNic pour incrémenter le compteur de référence de commutateur extensible, il n’est pas nécessaire de synchroniser ses appels pour transmettre ou transférer des demandes OID ou des indications d’état NDIS avec son code qui gère Hyper-V demandes OID extensibles de commutateur. Une fois l’extension incrémentée le compteur de référence, l’interface de commutateur extensible n’émet pas de requête 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 requête.

• 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, le bord 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 adaptateur physique sous-jacent. 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.

Remarque L’extension ne doit pas émettre ses propres requêtes d’ensemble d’OID de OID_SWITCH_NIC_DISCONNECT.

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 requête de requête OID de OID_SWITCH_NIC_DISCONNECT et retourne le code d’état suivant.

Exigences

Voir aussi

NDIS_OID_REQUEST

NDIS_SWITCH_NIC_PARAMETERS

OID_SWITCH_NIC_DELETE

OID_SWITCH_PORT_ARRAY

ReferenceSwitchPort