OID_SWITCH_PORT_UPDATED
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.
Statuscode | BESCHREIBUNG |
---|---|
NDIS_STATUS_SUCCESS |
Die OID-Anforderung wurde erfolgreich abgeschlossen. |
Requirements (Anforderungen)
Version |
Unterstützt in NDIS 6.30 und höher. |
Header |
Ntddndis.h (include Ndis.h) |