OID_SWITCH_PORT_UPDATED

Artikel
06/15/2023

Der Protokollrand des erweiterbaren Hyper-V-Switches gibt eine OID-Set-Anforderung (Object Identifier) von OID_SWITCH_PORT_UPDATED aus, um erweiterbare Switcherweiterungen über die Aktualisierung eines erweiterbaren Switchports zu benachrichtigen. Die OID wird nur für Ports ausgestellt, die bereits erstellt wurden und noch nicht mit dem Teardown-/Löschvorgang begonnen haben. Derzeit kann nur das Feld PortFriendlyName nach der Erstellung aktualisiert werden.

Das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf eine NDIS_SWITCH_NIC_SAVE_STATE-Struktur .

Bemerkungen

Der PortId-Member der NDIS_SWITCH_PORT_PARAMETERS-Struktur gibt den erweiterbaren Switchport an, für den die Updatebenachrichtigung erfolgt.

Die Erweiterung muss die folgenden Richtlinien für die Verarbeitung von OID-Satzanforderungen von OID_SWITCH_PORT_UPDATED befolgen:

Die Erweiterung darf die NDIS_SWITCH_PORT_PARAMETERS Struktur, die der OID-Anforderung zugeordnet ist, nicht ändern.
Die Erweiterung muss diese OID-Set-Anforderung immer an zugrunde liegende Erweiterungen weiterleiten. Bei der Erweiterung darf die Anforderung nicht fehlschlagen.

Hinweis Erweiterbare Switcherweiterungen dürfen keine OID-Set-Anforderungen von OID_SWITCH_PORT_UPDATED ausgeben.

Weitere Informationen zu den Zuständen von erweiterbaren Switchports und Netzwerkadapterverbindungen finden Sie unter Hyper-V Extensible Switch Port und Netzwerkadapterstatus.

Zurückgeben von Statuscodes

Der zugrunde liegende Miniportrand des erweiterbaren Schalters schließt die OID-Set-Anforderung von OID_SWITCH_PORT_UPDATED ab und gibt den folgenden status Code zurück.