OID_SWITCH_PORT_PROPERTY_UPDATE

Article
06/15/2023

Le bord du protocole du commutateur extensible Hyper-V émet une demande de jeu d’identificateur d’objet (OID) de OID_SWITCH_PORT_PROPERTY_UPDATE pour notifier les extensions de commutateur extensibles de la mise à jour d’une propriété pour une stratégie de port de commutateur extensible.

Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une mémoire tampon. Cette mémoire tampon contient les données suivantes :

Structure NDIS_SWITCH_PORT_PROPERTY_PARAMETERS qui spécifie l’identification et le type d’une propriété de port.
Mémoire tampon de propriétés qui contient les paramètres d’une stratégie de port. La mémoire tampon de propriété contient une structure basée sur le membre PropertyType de la structure NDIS_SWITCH_PORT_PROPERTY_PARAMETERS . Par exemple, si le membre PropertyType est défini sur NdisSwitchPortPropertyTypeVlan, la mémoire tampon de propriété contient une structure NDIS_SWITCH_PORT_PROPERTY_VLAN .

Notes

Une extension de transfert peut gérer la demande de jeu d’OID de OID_SWITCH_PORT_PROPERTY_UPDATE. Tous les autres types d’extensions doivent appeler NdisFOidRequest pour transférer la requête OID à l’extension suivante dans la pile de pilotes de commutateur extensible.

L’extension peut opposer son veto à la mise à jour de la propriété de port en retournant NDIS_STATUS_DATA_NOT_ACCEPTED pour la requête OID. Par exemple, si une extension ne peut pas allouer de ressources pour appliquer ses stratégies mises à jour sur le port, elle doit opposer son veto à la demande de mise à jour.

Note Si l’extension retourne d’autres codes d’erreur status NDIS_STATUS_Xxx, la notification de mise à jour 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 requête 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 les extensions sous-jacentes dans le chemin de contrôle du commutateur extensible ou par l’interface de commutateur extensible.

Pour obtenir des instructions sur la façon de gérer une demande d’ensemble OID de OID_SWITCH_PORT_PROPERTY_UPDATE, consultez Gestion des stratégies de port.

Codes d’état de retour

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

Code d’état	Description
NDIS_STATUS_INVALID_LENGTH	La longueur de la mémoire tampon d’informations est trop petite pour traiter la structure NDIS_SWITCH_PORT_PROPERTY_PARAMETERS et les données dans la mémoire tampon de propriétés de la structure. L’extension définit les DONNÉES. SET_INFORMATION. Le membre BytesNeeded dans le NDIS_OID_REQUEST structure à la taille de mémoire tampon minimale requise.
NDIS_STATUS_DATA_NOT_ACCEPTED	L’extension de transfert a opposé son veto à la notification de suppression de la stratégie de port.
NDIS_STATUS_NOT_SUPPORTED	L’extension de transfert ne prend pas en charge la stratégie de port.
NDIS_STATUS_Xxx	La demande OID a échoué pour d’autres raisons.

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