OID_SWITCH_PORT_CREATE

Article
06/15/2023

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_CREATE pour notifier les extensions de commutateur extensibles de la création d’un port de commutateur extensible.

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 pour lequel la notification de création est effectuée.

L’extension de commutateur extensible doit suivre ces instructions pour gérer les demandes de jeu OID de OID_SWITCH_PORT_CREATE :

L’extension ne doit pas modifier la structure NDIS_SWITCH_PORT_PARAMETERS associée à la requête OID.
L’extension peut opposer son veto à la notification de création en retournant NDIS_STATUS_DATA_NOT_ACCEPTED pour la demande OID. Par exemple, si une extension ne peut pas allouer de ressources pour appliquer ses stratégies configurées sur le port, le pilote doit opposer son veto à la notification de création.

Si l’extension retourne d’autres codes d’erreur NDIS_STATUS_Xxx status, la notification de création est également bloquée. Toutefois, le retour de codes status pour des scénarios temporaires, tels que le retour d’NDIS_STATUS_RESOURCES, peut entraîner une nouvelle tentative de la notification de création.

Si l’extension ne met pas son veto à la demande OID, elle doit surveiller la status lorsque la demande est terminée. L’extension doit effectuer cette opération pour déterminer si la demande OID a été bloquée par des extensions sous-jacentes dans le chemin de contrôle du commutateur extensible ou par l’interface de commutateur extensible.

Pour plus d’informations sur les stratégies de port, consultez Gestion des stratégies de commutateur extensible Hyper-V.
Si l’extension appelle NdisFOidRequest pour transférer cette demande de jeu d’OID, l’extension doit surveiller l’achèvement status de cette requête OID. L’extension effectue cette opération pour détecter si les extensions sous-jacentes de la pile de pilotes de commutateur extensible ont opposé un veto à la notification de création de port.
Une fois la demande OID transférée et terminée, l’extension peut émettre des demandes d’OID pour le port, telles que OID_SWITCH_PORT_PROPERTY_ENUM, jusqu’à ce qu’une demande OID de OID_SWITCH_PORT_TEARDOWN soit émise. Cette demande OID informe l’extension que le port commencera le processus de suppression du commutateur extensible.
Les extensions ne peuvent pas transférer les paquets vers le port spécifié dans la structure de NDIS_SWITCH_PORT_PARAMETERS tant qu’une demande de jeu d’OID_SWITCH_NIC_CONNECT OID n’est pas émise et s’est terminée correctement.

Note Les extensions ne doivent pas émettre de requêtes de jeu OID de OID_SWITCH_PORT_CREATE.

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

Codes d’état de retour

Si l’extension termine la demande de jeu OID de OID_SWITCH_PORT_CREATE, elle retourne l’un des codes status suivants.

Code d’état	Description
NDIS_STATUS_DATA_NOT_ACCEPTED	L’extension a opposé son veto à la notification de création.
NDIS_STATUS_RESOURCES	L’extension a opposé son veto à la notification de création en raison d’une condition de ressource faible.
NDIS_STATUS_Xxx	L’extension a opposé son veto à la notification de création pour d’autres raisons.

Note Si l’extension termine la demande de jeu OID, elle ne doit pas retourner NDIS_STATUS_SUCCESS.

Si l’extension ne termine pas la demande d’ensemble OID de OID_SWITCH_PORT_CREATE, la demande est effectuée par le bord miniport sous-jacent du commutateur extensible. Le bord du miniport sous-jacent retourne le code status suivant pour cette demande de jeu d’OID.