OID_SWITCH_NIC_SAVE

Article
06/15/2023

Le bord du protocole du commutateur extensible Hyper-V émet une demande de méthode d’identificateur d’objet (OID) de OID_SWITCH_NIC_SAVE au cours d’une opération afin d’économiser les données d’exécution d’un port de commutateur extensible et de 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 via des demandes 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.

Notes

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 des octets SaveDataOffset à partir du début de la structure.
Si le SaveDataSize fourni n’est pas assez grand pour contenir les données d’enregistrement requises, l’extension définit le champ BytesNeeded 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 contenir 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 demande de méthode OID avec NDIS_STATUS_SUCCESS. Ainsi, le bord du protocole du commutateur extensible émet une autre demande de méthode OID pour permettre à l’extension de retourner davantage de données d’enregistrement ou d’autoriser d’autres extensions en bas de la pile à enregistrer leurs propres données.

Note 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 les champs Header, PortId, NicIdex, SaveDataSize et SaveDataOffset de la structure avant d’émettre l’OID. L’extension ne peut pas modifier ces champs.

Les demandes 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 avertit 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 Enregistrement des données Run-Time de commutateur extensible Hyper-V.

Codes d’état de retour

L’extension de commutateur extensible retourne l’un des codes de status suivants pour la demande 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 le NDIS_SWITCH_NIC_SAVE_STATE et ses données d’exécution associées L’extension de commutateur extensible doit définir les DONNÉES. METHOD_INFORMATION. Le membre BytesNeeded dans le NDIS_OID_REQUEST structure à la taille de mémoire tampon minimale requise.
NDIS_STATUS_SUCCESS	L’extension retourne cette status si elle retourne des données d’exécution à enregistrer.
NDIS_STATUS_Xxx	La demande a échoué pour d’autres raisons.