OID_SWITCH_NIC_RESTORE

Articolo
06/15/2023

Il bordo del protocollo del commutatore estendibile Hyper-V genera una richiesta di set OID (Object Identifier) di OID_SWITCH_NIC_RESTORE per notificare all'estensione del commutatore estendibile i dati di runtime che possono essere ripristinati per una porta commutatore estendibile e la relativa connessione alla scheda di rete.

Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a una struttura NDIS_SWITCH_NIC_SAVE_STATE . Questa struttura viene allocata dal bordo del protocollo del commutatore estendibile.

Commenti

Quando riceve la richiesta del set OID di OID_SWITCH_NIC_RESTORE, l'estensione del commutatore estendibile deve innanzitutto determinare se possiede i dati di runtime. L'estensione esegue questa operazione confrontando il valore del membro ExtensionId della struttura NDIS_SWITCH_NIC_SAVE_STATE con il valore GUID usato dall'estensione per identificarsi.

Se l'estensione possiede i dati di runtime per una porta del commutatore estendibile, i dati vengono ripristinati nel modo seguente:

L'estensione copia i dati di runtime nel membro SaveData nell'archiviazione allocata dall'estensione.

Nota Il valore del membro PortId della struttura NDIS_SWITCH_NIC_SAVE_STATE può essere diverso dal valore PortId al momento del salvataggio dei dati in fase di esecuzione. Ciò può verificarsi se i dati di runtime sono stati salvati durante una migrazione in tempo reale da un host a un altro. Tuttavia, la configurazione della porta del commutatore estendibile viene mantenuta durante la migrazione in tempo reale. In questo modo l'estensione consente di ripristinare i dati di runtime sulla porta del commutatore estendibile usando il nuovo valore PortId .
L'estensione completa la richiesta del set OID con NDIS_STATUS_SUCCESS.

Se l'estensione non possiede i dati di runtime specificati, l'estensione chiama NdisFOidRequest per inoltrare questa richiesta di set OID alle estensioni sottostanti nello stack del driver del commutatore estendibile. In questo caso, l'estensione non deve modificare la struttura NDIS_SWITCH_NIC_SAVE_STATE associata alla richiesta OID.

Se la richiesta set di OID_SWITCH_NIC_RESTORE viene ricevuta dal bordo miniport dell'opzione estendibile, completa la richiesta OID con NDIS_STATUS_SUCCESS. In questo modo viene informato il bordo del protocollo del commutatore estendibile che nessuna estensione possiede i dati di runtime.

Per altre informazioni su come ripristinare i dati di runtime, vedere Ripristino del commutatore estendibile Hyper-V Run-Time Dati.

Nota Se l'estensione non riesce la richiesta del set OID, l'opzione estendibile avrà esito negativo per l'intera operazione di ripristino. Di conseguenza, l'estensione deve evitare l'esito negativo della richiesta OID, se possibile. Ad esempio, se l'estensione non può allocare la risorsa necessaria per ripristinare i dati di runtime, deve non riuscire la richiesta OID se non riesce a funzionare correttamente senza ripristinare i dati di runtime. Tuttavia, se l'estensione può essere ripristinata dalla condizione di errore, non deve avere esito negativo la richiesta del set OID.