Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Le bord du protocole du commutateur extensible Hyper-V émet une demande de jeu d’identificateur d’objet (OID) de OID_SWITCH_NIC_CONNECT pour avertir les extensions de commutateur extensible sous-jacentes qu’une connexion réseau entre un port de commutateur extensible et une carte réseau est complètement établie. La périphérie du protocole a précédemment averti les extensions que cette connexion est établie lorsqu’elle a émis 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.
Remarques
Le PortId membre 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 l'NetEventSwitchActivateNET_PNP_EVENT est émis par l’adaptateur miniport d’extension.
En inspectant les différentes demandes de jeux d’OID de OID_SWITCH_PORT_CREATE et de OID_SWITCH_PORT_DELETE.
L’index membre 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 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.
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 cartes réseau physiques.
Remarque L’extension ne doit pas émettre ses propres requêtes d’ensemble 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 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_NIC_CONNECT 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) |