OID_SWITCH_NIC_SAVE

Article
03/13/2025

La périphérie du protocole du commutateur extensible Hyper-V émet une demande de méthode d’identificateur d’objet (OID) de OID_SWITCH_NIC_SAVE pendant une opération pour économiser les données d’exécution pour un port de commutateur extensible et sa connexion de carte réseau. L’extension retourne ces données afin que les données d’exécution puissent être enregistrées et restaurées ultérieurement. Une fois les données d’exécution enregistrées, elles sont restaurées par le biais de requêtes de jeu d’OID de OID_SWITCH_NIC_RESTORE.

Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_SWITCH_NIC_SAVE_STATE. Cette structure est allouée par le bord du protocole du commutateur extensible.

Remarques

Lorsqu’elle reçoit la demande de méthode OID de OID_SWITCH_NIC_SAVE, l’extension de commutateur extensible enregistre les données d’exécution en procédant comme suit :

L’extension enregistre les données dans la structure NDIS_SWITCH_NIC_SAVE_STATE à partir de SaveDataOffset octets à partir du début de la structure.
Si la SaveDataSize fournie n’est pas suffisamment grande pour contenir les données d’enregistrement requises, l’extension définit le champ BytesNeededed de la structure de méthode sur NDIS_SIZEOF_NDIS_SWITCH_NIC_SAVE_STATE_REVISION_1 plus la quantité de mémoire tampon nécessaire pour stocker les données d’enregistrement et termine l’OID avec NDIS_STATUS_BUFFER_TOO_SHORT. L’OID sera réédité avec la taille requise.
L’extension remplit les champs ExtensionId et ExtensionFriendlyName avec son propre identificateur et son nom, et termine la requête de méthode OID avec NDIS_STATUS_SUCCESS. Cela entraîne l’émission d’une autre demande de méthode OID à l’arête du protocole du commutateur extensible pour permettre à l’extension de retourner davantage de données d’enregistrement, ou d’autoriser d’autres extensions dans la pile à enregistrer leurs propres données.

Remarque Si l’extension n’a pas de données d’exécution à enregistrer, elle doit appeler NdisFOidRequest pour transférer cette demande de méthode OID aux extensions sous-jacentes dans la pile de pilotes de commutateur extensible. Pour plus d’informations sur cette procédure, consultez filtrage des requêtes OID dans un pilote de filtre NDIS.

Le commutateur extensible Hyper-V remplit le d’en-tête, portId, NicIdex, SaveDataSize et champs SaveDataOffset de la structure avant d’émettre l’OID. L’extension ne peut pas modifier ces champs.

Les requêtes de méthode OID de OID_SWITCH_NIC_SAVE sont finalement gérées par le bord miniport sous-jacent du commutateur extensible. Une fois que cette demande de méthode OID a été reçue par le bord miniport du commutateur extensible, elle termine la requête OID avec NDIS_STATUS_SUCCESS. Cela informe le bord du protocole du commutateur extensible que toutes les extensions de la pile de pilotes de commutateur extensible ont été interrogées pour les données d’exécution. Le bord du protocole du commutateur extensible émet ensuite une demande de jeu d’OID de OID_SWITCH_NIC_SAVE_COMPLETE pour terminer l’opération d’enregistrement.

Pour plus d’informations sur l’enregistrement des données d’exécution pour un port de commutateur extensible, consultez Enregistrer Hyper-V commutateur extensible Run-Time données.

Codes d’état de retour

L’extension de commutateur extensible retourne l’un des codes d’état suivants pour la requête de méthode OID de OID_SWITCH_NIC_SAVE.

Code d’état	Description
NDIS_STATUS_BUFFER_TOO_SHORT	La longueur de la mémoire tampon d’informations est trop petite pour l'NDIS_SWITCH_NIC_SAVE_STATE et ses données d’exécution associées L’extension de commutateur extensible doit définir l'DATA. METHOD_INFORMATION. OctetsNeeded membre de la structure NDIS_OID_REQUEST à la taille minimale de mémoire tampon requise.
NDIS_STATUS_SUCCESS	L’extension retourne cet état s’il retourne des données d’exécution à enregistrer.
NDIS_STATUS_Xxx	La demande a échoué pour d’autres raisons.