OID_SWITCH_PORT_PROPERTY_ADD

Article
06/15/2023

Le bord du protocole du commutateur extensible Hyper-V émet une demande d’ensemble d’identificateur d’objet (OID) de OID_SWITCH_PORT_PROPERTY_ADD pour informer les extensions de commutateur extensible de l’ajout d’une propriété de stratégie pour un 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 de paramètres d’une stratégie 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_ADD. 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 à l’ajout 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 configurées sur le port, elle doit opposer son veto à la demande d’ajout.

Note 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 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 d’OID de OID_SWITCH_PORT_PROPERTY_ADD, 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_ADD, elle retourne l’un des codes de 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 d’ajout de 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_ADD, la demande est effectuée par le bord miniport sous-jacent du commutateur extensible. Le bord du miniport renvoie le code status suivant :