OID_SWITCH_NIC_RESTORE

Artikel
06/15/2023

Der Protokollrand des erweiterbaren Hyper-V-Switches stellt eine OID-Set-Anforderung von OID_SWITCH_NIC_RESTORE aus, um die erweiterbare Switcherweiterung über Laufzeitdaten zu benachrichtigen, die für einen erweiterbaren Switchport und dessen 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 zugeordnet.

Bemerkungen

Wenn sie die OID-Set-Anforderung von OID_SWITCH_NIC_RESTORE empfängt, muss die erweiterbare Switcherweiterung zuerst ermitteln, ob sie besitzer der Laufzeitdaten ist. Die Erweiterung vergleicht dazu den Wert des ExtensionId-Members der NDIS_SWITCH_NIC_SAVE_STATE-Struktur mit dem GUID-Wert, den die Erweiterung verwendet, um sich selbst zu identifizieren.

Wenn die Erweiterung die Laufzeitdaten für einen erweiterbaren Switchport besitzt, werden diese Daten wie folgt wiederhergestellt:

Die Erweiterung kopiert die Laufzeitdaten im SaveData-Member in den durch die Erweiterung zugewiesenen Speicher.

Hinweis Der Wert des PortId-Members der NDIS_SWITCH_NIC_SAVE_STATE-Struktur kann sich zum Zeitpunkt des Speicherns der Laufzeitdaten vom PortId-Wert unterscheiden. Dies kann auftreten, 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 PortId-Werts im erweiterbaren Switchport wiederherstellen.
Die Erweiterung schließt die OID-Setanforderung mit NDIS_STATUS_SUCCESS ab.

Wenn die Erweiterung nicht im Besitz der angegebenen Laufzeitdaten ist, 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 Switches 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 Restoreing Hyper-V Extensible Switch Run-Time Data.

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