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