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) |