OID_SWITCH_NIC_RESTORE

La périphérie du protocole du commutateur extensible Hyper-V émet une demande de jeu d’identificateur d’objet (OID) de OID_SWITCH_NIC_RESTORE pour notifier l’extension de commutateur extensible sur les données d’exécution qui peuvent être restaurées pour un port de commutateur extensible et sa connexion de carte réseau.

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 jeu OID de OID_SWITCH_NIC_RESTORE, l’extension de commutateur extensible doit d’abord déterminer si elle possède les données d’exécution. L’extension effectue cette opération en comparant la valeur du ExtensionId membre de la structure NDIS_SWITCH_NIC_SAVE_STATE à la valeur GUID utilisée par l’extension pour s’identifier elle-même.

Si l’extension possède les données d’exécution d’un port de commutateur extensible, elle restaure ces données de la manière suivante :

1. L’extension copie les données d’exécution dans le membre SaveData dans le stockage alloué à l’extension.

   Remarque La valeur du portId membre de la structure NDIS_SWITCH_NIC_SAVE_STATE peut être différente de la valeur portId au moment où les données d’exécution ont été enregistrées. Cela peut se produire si les données d’exécution ont été enregistrées pendant une migration dynamique d’un hôte vers un autre. Toutefois, la configuration du port de commutateur extensible est conservée pendant la migration dynamique. Cela permet à l’extension de restaurer les données d’exécution sur le port de commutateur extensible à l’aide de la nouvelle valeur PortId.

2. L’extension termine la requête de jeu OID avec NDIS_STATUS_SUCCESS.

Si l’extension ne possède pas les données d’exécution spécifiées, l’extension appelle NdisFOidRequest pour transférer cette demande de jeu OID aux extensions sous-jacentes dans la pile de pilotes de commutateur extensible. Dans ce cas, l’extension ne doit pas modifier la structure NDIS_SWITCH_NIC_SAVE_STATE associée à la requête OID.

Si la demande de jeu de OID_SWITCH_NIC_RESTORE est 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 qu’aucune extension ne possède les données d’exécution.

Pour plus d’informations sur la restauration des données au moment de l’exécution, consultez Restauration Hyper-V commutateur extensible Run-Time data.

Remarque Si l’extension échoue la demande de jeu d’OID, le commutateur extensible échouera toute l’opération de restauration. Par conséquent, l’extension doit éviter d’échouer la requête OID si elle est possible. Par exemple, si l’extension ne peut pas allouer la ressource nécessaire pour restaurer les données d’exécution, elle doit échouer à la demande OID si elle ne peut pas fonctionner correctement sans restaurer les données d’exécution. Toutefois, si l’extension peut récupérer à partir de la condition d’échec, elle ne doit pas échouer la demande de jeu d’OID.

Codes d’état de retour

Si l’extension termine la demande d’ensemble OID de OID_SWITCH_NIC_RESTORE, elle retourne l’un des codes d’état suivants.

Exigences

Voir aussi

NDIS_OID_REQUEST

NDIS_SWITCH_NIC_SAVE_STATE

NdisFOidRequest