OID_SWITCH_NIC_SAVE

Artikel
03/13/2025

Der Protokollrand des Hyper-V erweiterbaren Switchs gibt eine OID-Methodenanforderung (Object Identifier) von OID_SWITCH_NIC_SAVE während eines Vorgangs aus, um Laufzeitdaten für einen erweiterbaren Switchport und dessen Netzwerkadapterverbindung zu speichern. Die Erweiterung gibt diese Daten zurück, sodass Laufzeitdaten zu einem späteren Zeitpunkt gespeichert und wiederhergestellt werden können. Nachdem die Laufzeitdaten gespeichert wurden, wird sie über OID-Set-Anforderungen von OID_SWITCH_NIC_RESTOREwiederhergestellt.

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-Methodenanforderung von OID_SWITCH_NIC_SAVE empfängt, speichert die erweiterbare Switcherweiterung Laufzeitdaten, indem Sie die folgenden Schritte ausführen:

Die Erweiterung speichert die Daten innerhalb der NDIS_SWITCH_NIC_SAVE_STATE Struktur ab SaveDataOffset- Bytes vom Anfang der Struktur.
Wenn die bereitgestellte SaveDataSize- nicht groß genug ist, um die erforderlichen Speicherdaten zu speichern, legt die Erweiterung das ByteNeeded Feld der Methode auf NDIS_SIZEOF_NDIS_SWITCH_NIC_SAVE_STATE_REVISION_1 plus die Menge des Puffers fest, der zum Speichern der Daten erforderlich ist, und schließt das OID mit NDIS_STATUS_BUFFER_TOO_SHORT ab. Das OID wird mit der erforderlichen Größe neu ausgegeben.
Die Erweiterung füllt die felder ExtensionId und ExtensionFriendlyName mit eigenem Bezeichner und Namen auf und schließt die OID-Methodenanforderung mit NDIS_STATUS_SUCCESS ab. Dies bewirkt, dass der Protokollrand des erweiterbaren Switches eine weitere OID-Methodenanforderung ausgibt, damit die Erweiterung entweder mehr Speicherdaten zurückgibt, oder andere Erweiterungen den Stapel herunter, um ihre eigenen Daten zu speichern.

Hinweis Wenn die Erweiterung keine Laufzeitdaten zum Speichern enthält, muss sie NdisFOidRequest- aufrufen, um diese OID-Methodenanforderung an zugrunde liegende Erweiterungen im erweiterbaren Switchtreiberstapel weiterzuleiten. Weitere Informationen zu diesem Verfahren finden Sie unter Filtern von OID-Anforderungen in einem NDIS-Filtertreiber.

Der Hyper-V erweiterbare Schalter füllt die Header, PortId, NicIdex, SaveDataSize und SaveDataOffset Felder der Struktur aus, bevor sie das OID ausstellen. Die Erweiterung kann diese Felder nicht ändern.

OID-Methodenanforderungen von OID_SWITCH_NIC_SAVE werden letztendlich vom zugrunde liegenden Miniportrand des erweiterbaren Schalters behandelt. Nachdem diese OID-Methodenanforderung vom Miniportrand des erweiterbaren Schalters empfangen wurde, wird die OID-Anforderung mit NDIS_STATUS_SUCCESS abgeschlossen. Dadurch wird der Protokollrand des erweiterbaren Switches benachrichtigt, dass alle Erweiterungen im erweiterbaren Switchtreiberstapel zur Laufzeitdaten abgefragt wurden. Der Protokollrand des erweiterbaren Schalters gibt dann eine OID-Setanforderung von OID_SWITCH_NIC_SAVE_COMPLETE aus, um den Speichervorgang abzuschließen.

Weitere Informationen zum Speichern von Laufzeitdaten für einen erweiterbaren Switchport finden Sie unter Speichern Hyper-V Extensible Switch Run-Time Data.

Rückgabestatuscodes

Die erweiterbare Switcherweiterung gibt einen der folgenden Statuscodes für die OID-Methodenanforderung von OID_SWITCH_NIC_SAVE zurück.

Statuscode	Beschreibung
NDIS_STATUS_BUFFER_TOO_SHORT	Die Länge des Informationspuffers ist für die NDIS_SWITCH_NIC_SAVE_STATE zu klein und die zugehörigen Laufzeitdaten Die erweiterbare Switcherweiterung muss die DATA festlegen. METHOD_INFORMATION. BytesNeeded Member in der NDIS_OID_REQUEST Struktur auf die erforderliche Mindestpuffergröße.
NDIS_STATUS_SUCCESS	Die Erweiterung gibt diesen Status zurück, wenn Laufzeitdaten zurückgegeben werden, die gespeichert werden sollen.
NDIS_STATUS_Xxx-	Fehler bei der Anforderung aus anderen Gründen.

Der zugrunde liegende Miniportrand des erweiterbaren Schalters gibt den folgenden Statuscode für die OID-Methodenanforderung von OID_SWITCH_NIC_SAVE zurück.