OID_SWITCH_PORT_CREATE

Le bord 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 sur la création d’un port de commutateur extensible.

Le InformationBuffer membre de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_SWITCH_PORT_PARAMETERS.

Remarques

Le PortId membre 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 d’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 refuser 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 refuser la notification de création.

  Si l’extension retourne d’autres NDIS_STATUS_xxx codes d’état d’erreur, la notification de création est également mise en attente. Toutefois, le retour de codes d’état pour les scénarios transitaires, tels que le retour de NDIS_STATUS_RESOURCES, peut entraîner une nouvelle tentative de la notification de création.

  Si l’extension n’oppose pas de veto à la demande OID, elle doit surveiller l’état lorsque la demande est terminée. L’extension doit effectuer cette opération pour déterminer si la demande OID a été mise en opposition par les extensions sous-jacentes dans le chemin de contrôle de 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’état d’achèvement de cette demande OID. L’extension effectue cette opération pour détecter si les extensions sous-jacentes dans la pile de pilotes de commutateur extensible ont annulé la notification de création de port.

• Une fois la requête 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 avertit 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 NDIS_SWITCH_PORT_PARAMETERS tant qu’une demande de jeu d’OID de OID_SWITCH_NIC_CONNECT est émise et qu’elle est terminée avec succès.

Remarque Extensions ne doivent pas émettre de requêtes définies par OID de OID_SWITCH_PORT_CREATE.

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

Si l’extension termine la demande d’ensemble OID de OID_SWITCH_PORT_CREATE, elle retourne l’un des codes d’état suivants.

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

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

Exigences

Voir aussi

NDIS_OID_REQUEST

NDIS_SWITCH_PORT_PARAMETERS

NdisFOidRequest

OID_SWITCH_NIC_CONNECT

OID_SWITCH_PORT_ARRAY

OID_SWITCH_PORT_PROPERTY_ENUM