OID_SWITCH_NIC_CONNECT

Article
07/08/2024

Le bord du protocole du commutateur extensible Hyper-V émet une demande de définition d’identificateur d’objet (OID) de OID_SWITCH_NIC_CONNECT pour notifier les extensions de commutateur extensible sous-jacentes qu’une connexion réseau entre un port de commutateur extensible et une carte réseau est entièrement établie. La périphérie du protocole a précédemment averti les extensions que cette connexion est établie lors de l’émission d’une demande de jeu d’OID de OID_SWITCH_NIC_CREATE.

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 de commutateur extensible pour lequel la notification de connexion est effectuée. L’extension de commutateur extensible peut obtenir les informations de paramètre pour ce port et d’autres ports de commutateur extensible de la manière suivante :

En émettant des requêtes OID de OID_SWITCH_PORT_ARRAY. L’extension émet cet OID sur FilterAttach uniquement lorsque OID_SWITCH_PARAMETERS retourne une structure NDIS_SWITCH_PARAMETERS avec IsActive défini sur TRUE. Si IsActive a la valeur FALSE, l’extension émet l’OID lorsque le NET_PNP_EVENT NetEventSwitchActivate est émis par l’adaptateur miniport d’extension.
En inspectant les différentes demandes de OID_SWITCH_PORT_CREATE et de OID_SWITCH_PORT_DELETE des jeux d’OID.

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

Lorsqu’elle reçoit la demande d’ensemble OID de OID_SWITCH_NIC_CONNECT, l’extension doit suivre les instructions suivantes :

Une fois la requête OID_SWITCH_NIC_CONNECT terminée avec NDIS_STATUS_SUCCESS, la connexion réseau et le port de commutateur extensible sont entièrement opérationnels. L’extension peut générer ou transférer le trafic de paquets vers la connexion réseau du port. L’extension peut également émettre des OID de commutateur extensible ou des indications d’état qui utilisent le port comme port source. L’extension peut également appeler ReferenceSwitchPort pour incrémenter le compteur de référence de commutateur extensible pour le port.
L’extension ne doit pas modifier la structure NDIS_SWITCH_NIC_PARAMETERS associée à la requête OID.
L’extension doit toujours appeler NdisFOidRequest pour transférer cette requête OID aux extensions sous-jacentes. L’extension ne doit pas terminer la requête OID elle-même.
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 requête de jeu d’OID distincte de OID_SWITCH_NIC_CONNECT. 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, consultez Valeurs d’index de carte réseau.

L’extension doit conserver l’état de connexion pour chaque carte physique sous-jacente liée à la carte réseau externe. 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.

Notez que l’extension ne doit pas émettre ses propres requêtes de jeu d’OID de OID_SWITCH_NIC_CONNECT.

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