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