OID_SWITCH_PORT_PROPERTY_ADD

Article
03/13/2025

Le bord du protocole de la Hyper-V commutateur extensible émet une demande de jeu d’identificateur d’objet (OID) de OID_SWITCH_PORT_PROPERTY_ADD pour notifier les extensions de commutateur extensibles sur l’ajout d’une propriété de stratégie pour un port de commutateur extensible.

Le InformationBuffer membre 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é 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 PropertyType membre 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.

Remarques

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 refuser l’ajout de la propriété de port 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, elle doit refuser la demande d’ajout.

Remarque Si l’extension retourne d’autres codes d’état d’erreur xxx NDIS_STATUS_Xxx, la notification de création est également mise à part. 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 obtenir des instructions sur la gestion d’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 d’OID_SWITCH_PORT_PROPERTY_ADD de jeu d’OID, elle retourne l’un des codes d’état 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é de la structure. L’extension définit le DATA. SET_INFORMATION. OctetsNeeded membre de la structure NDIS_OID_REQUEST à la taille de mémoire tampon minimale requise.
NDIS_STATUS_DATA_NOT_ACCEPTED	L’extension de transfert a bloqué 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 requête OID a échoué pour d’autres raisons.

Si l’extension ne termine pas la demande d’ensemble OID de OID_SWITCH_PORT_PROPERTY_ADD, la requête est terminée par le bord miniport sous-jacent du commutateur extensible. Le bord miniport retourne le code d’état suivant :