OID_SWITCH_PORT_TEARDOWN
La périphérie du protocole du commutateur extensible Hyper-V émet une demande de jeu d’identificateur d’objet (OID) de OID_SWITCH_PORT_TEARDOWN pour avertir les extensions de commutateur extensible sous-jacentes qu’un port de commutateur extensible commencera le processus de suppression. Ce processus est démarré lorsque le pilote de protocole émet une demande de jeu d’OID de OID_SWITCH_PORT_DELETE.
Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_SWITCH_PORT_PARAMETERS .
Notes
Le membre PortId de la structure NDIS_SWITCH_PORT_PARAMETERS spécifie le port de commutateur extensible pour lequel la notification de connexion est effectuée. L’extension de commutateur extensible doit mettre à jour toutes les informations mises en cache sur le port qu’elle a obtenu 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 est FALSE, l’extension émet l’OID lorsque le NET_PNP_EVENT NetEventSwitchActivate est émis par le 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 bord du protocole du commutateur extensible émet une demande de jeu d’OID de OID_SWITCH_PORT_TEARDOWN pour notifier l’extension qu’un port est en cours de suppression du commutateur extensible. Avant que cette demande OID soit émise, le bord du protocole du commutateur extensible avait précédemment émis les OID suivants si le port disposait d’une connexion de carte réseau active :
OID_SWITCH_NIC_DISCONNECT, qui a averti les extensions sous-jacentes que la carte réseau n’est plus connectée au port spécifié dans la structure NDIS_SWITCH_PORT_PARAMETERS.
OID_SWITCH_NIC_DELETE, qui a averti les extensions sous-jacentes que la connexion réseau entre la carte réseau et le port de commutateur extensible a été supprimée.
La périphérie du protocole émet cette demande de jeu d’OID après que tous les paquets en attente pour le port de commutateur extensible spécifié ont été annulés ou terminés.
Une fois l’extension terminée cette demande de jeu OID et le compteur de référence pour le port de commutateur extensible est égal à zéro, le bord du protocole du commutateur extensible émet une demande de jeu d’OID de OID_SWITCH_PORT_DELETE. Cette demande OID supprime le port du commutateur extensible.
Notez qu’une extension incrémente le compteur de référence pour un port de commutateur extensible en appelant ReferenceSwitchPort. Une extension décrémente le compteur de référence en appelant DereferenceSwitchPort.
L’extension doit suivre ces instructions pour gérer les demandes de jeu d’OID de OID_SWITCH_PORT_TEARDOWN :
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.
Notez que l’extension ne doit pas modifier la structure NDIS_SWITCH_PORT_PARAMETERS associée à la requête OID.
Une fois l’extension transférée cette requête OID, elle 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é.
Notez que l’extension ne doit pas émettre de requêtes de jeu d’OID de OID_SWITCH_PORT_TEARDOWN.
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.
Codes d’état de retour
Le bord miniport sous-jacent du commutateur extensible termine la demande de jeu d’OID de OID_SWITCH_PORT_TEARDOWN 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. |
Spécifications
Version |
Prise en charge dans NDIS 6.30 et versions ultérieures. |
En-tête |
Ntddndis.h (inclut Ndis.h) |