OID_SWITCH_PORT_PROPERTY_UPDATE

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 sur la mise à jour d’une propriété pour une stratégie de 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 d’une propriété 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_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 refuser 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 refuser la demande de mise à jour.

Remarque Si l’extension retourne d’autres codes d’état d’erreur NDIS_STATUS_Xxx, la notification de mise à jour 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_UPDATE, consultez Gestion des stratégies de port.

Codes d’état de retour

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

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

Exigences

Voir aussi

NDIS_OID_REQUEST

NDIS_SWITCH_PORT_PROPERTY_CUSTOM

NDIS_SWITCH_PORT_PROPERTY_PARAMETERS

NDIS_SWITCH_PORT_PROPERTY_VLAN

NdisFOidRequest