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 de la mise à jour des paramètres d’une propriété de stratégie 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_PROPERTY_PARAMETERS qui spécifie l’identification et le type d’une stratégie de commutateur extensible.

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

    Note À compter 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.

Notes

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 opposer son veto à 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 opposer son veto à la demande de mise à jour.

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_PROPERTY_UPDATE, consultez Gestion des stratégies de basculement.

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 de status suivants.

Code d’état Description

NDIS_STATUS_DATA_NOT_ACCEPTED

L’extension a opposé son veto à la notification de mise à jour de la stratégie de commutateur.

NDIS_STATUS_FAILURE

La demande OID a échoué pour d’autres raisons.

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

Code d’état Description

NDIS_STATUS_SUCCESS

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

Spécifications

Version

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

En-tête

Ntddndis.h (inclure Ndis.h)

Voir aussi


NDIS_OID_REQUEST

NDIS_SWITCH_PROPERTY_CUSTOM

NDIS_SWITCH_PROPERTY_PARAMETERS

NdisFOidRequest