OID_SWITCH_PROPERTY_ADD

Le bord du protocole du commutateur extensible Hyper-V émet une demande de jeu d’identificateur d’objet (OID) de OID_SWITCH_PROPERTY_ADD pour notifier les extensions de commutateur extensibles de l’ajout d’une propriété de stratégie de commutateur

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_ADD. 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 à l’ajout 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 d’ajout.

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

Codes d’état de retour

Si l’extension de transfert termine la demande de jeu d’OID de OID_SWITCH_PROPERTY_ADD, elle retourne l’un des codes status suivants.

Code d’état	Description
NDIS_STATUS_DATA_NOT_ACCEPTED	L’extension a opposé son veto à la notification d’ajout de 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_ADD, 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