Partager via


OID_SWITCH_PROPERTY_UPDATE

Le bord du protocole du commutateur extensible Hyper-V émet une demande de jeu d’identificateur d’objet (OID) de OID_SWITCH_PROPERTY_UPDATE pour notifier les extensions de commutateur extensibles sur la mise à jour des paramètres d’une propriété de stratégie 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_PROPERTY_PARAMETERS qui spécifie l’identification et le type d’une stratégie de commutateur extensible.

  • Mémoire tampon de propriété qui contient les paramètres d’une stratégie de commutateur extensible. La mémoire tampon de propriété contient une structure basée sur le PropertyType membre de la structure NDIS_SWITCH_PROPERTY_PARAMETERS.

    Remarque à partir de Windows Server 2012, le membre PropertyType doit être défini sur NdisSwitchPropertyTypeCustom et la mémoire tampon de propriété doit contenir une structure NDIS_SWITCH_PROPERTY_CUSTOM.

Remarques

Une extension de transfert peut gérer la demande de jeu d’OID de OID_SWITCH_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é switch 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 commutateur, elle doit refuser la demande de mise à jour.

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 OID de OID_SWITCH_PROPERTY_UPDATE, consultez Gestion des stratégies de commutateur.

Codes d’état de retour

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

Code d’état Description

NDIS_STATUS_DATA_NOT_ACCEPTED

L’extension a bloqué la notification de mise à jour de la stratégie de commutateur.

NDIS_STATUS_FAILURE

La requête OID a échoué pour d’autres raisons.

Si l’extension ne termine pas la demande d’ensemble OID de OID_SWITCH_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.

Code d’état Description

NDIS_STATUS_SUCCESS

La requête OID s’est terminée avec succès.

Exigences

Version

Prise en charge dans NDIS 6.30 et versions ultérieures.

En-tête

Ntddndis.h (include Ndis.h)

Voir aussi


NDIS_OID_REQUEST

NDIS_SWITCH_PROPERTY_CUSTOM

NDIS_SWITCH_PROPERTY_PARAMETERS

NdisFOidRequest