OID_SWITCH_NIC_RESTORE

Der Protokollrand des Hyper-V erweiterbaren Switches gibt eine OID-Setanforderung (Object Identifier) von OID_SWITCH_NIC_RESTORE aus, um die erweiterbare Switcherweiterung über Laufzeitdaten zu benachrichtigen, die für einen erweiterbaren Switchport und seine Netzwerkadapterverbindung wiederhergestellt werden können.

Das InformationBuffer Element der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf eine NDIS_SWITCH_NIC_SAVE_STATE Struktur. Diese Struktur wird vom Protokollrand des erweiterbaren Switches zugewiesen.

Bemerkungen

Wenn sie die OID-Set-Anforderung von OID_SWITCH_NIC_RESTORE empfängt, muss die erweiterbare Switcherweiterung zuerst bestimmen, ob sie die Laufzeitdaten besitzt. Die Erweiterung vergleicht dies, indem der Wert der ExtensionId Member der NDIS_SWITCH_NIC_SAVE_STATE Struktur mit dem GUID-Wert verglichen wird, den die Erweiterung verwendet, um sich selbst zu identifizieren.

Wenn die Erweiterung die Laufzeitdaten für einen erweiterbaren Switchport besitzt, stellt sie diese Daten wie folgt wieder her:

1. Die Erweiterung kopiert die Laufzeitdaten im SaveData- Mitglied in durch Erweiterung zugewiesenen Speicher.

   Hinweis Der Wert der PortId Member der NDIS_SWITCH_NIC_SAVE_STATE-Struktur kann sich vom wert PortId zum Zeitpunkt des Speicherns der Laufzeitdaten unterscheiden. Dies kann vorkommen, wenn Laufzeitdaten während einer Livemigration von einem Host zu einem anderen gespeichert wurden. Die Konfiguration des erweiterbaren Switchports wird jedoch während der Livemigration beibehalten. Dadurch kann die Erweiterung die Laufzeitdaten mithilfe des neuen Port Port wiederherstellen.

2. Die Erweiterung schließt die OID-Setanforderung mit NDIS_STATUS_SUCCESS ab.

Wenn die Erweiterung nicht über die angegebenen Laufzeitdaten verfügt, ruft die Erweiterung NdisFOidRequest auf, um diese OID-Setanforderung an zugrunde liegende Erweiterungen im erweiterbaren Switchtreiberstapel weiterzuleiten. In diesem Fall darf die Erweiterung die NDIS_SWITCH_NIC_SAVE_STATE Struktur, die der OID-Anforderung zugeordnet ist, nicht ändern.

Wenn die OID_SWITCH_NIC_RESTORE set-Anforderung vom Miniportrand des erweiterbaren Schalters empfangen wird, wird die OID-Anforderung mit NDIS_STATUS_SUCCESS abgeschlossen. Dadurch wird der Protokollrand des erweiterbaren Switches benachrichtigt, dass keine Erweiterung die Laufzeitdaten besitzt.

Weitere Informationen zum Wiederherstellen von Laufzeitdaten finden Sie unter Wiederherstellen Hyper-V Extensible Switch Run-Time Data.

Hinweis Wenn die Erweiterung die OID-Setanforderung fehlschlägt, schlägt der erweiterbare Switch den gesamten Wiederherstellungsvorgang fehl. Daher sollte die Erweiterung vermeiden, dass die OID-Anforderung fehlschlägt, wenn dies möglich ist. Wenn die Erweiterung beispielsweise die zum Wiederherstellen der Laufzeitdaten erforderliche Ressource nicht zuordnen kann, sollte die OID-Anforderung fehlschlagen, wenn sie nicht ordnungsgemäß funktionieren kann, ohne die Laufzeitdaten wiederherzustellen. Wenn die Erweiterung jedoch von der Fehlerbedingung wiederhergestellt werden kann, sollte die OID-Setanforderung nicht fehlschlagen.

Rückgabestatuscodes

Wenn die Erweiterung die OID-Setanforderung von OID_SWITCH_NIC_RESTORE abgeschlossen hat, gibt sie einen der folgenden Statuscodes zurück.

Anforderungen

Siehe auch

NDIS_OID_REQUEST

NDIS_SWITCH_NIC_SAVE_STATE

NdisFOidRequest