OID_SWITCH_NIC_UPDATED
Der Protokollrand des erweiterbaren Hyper-V-Switches gibt eine OID-Set-Anforderung (Object Identifier) von OID_SWITCH_NIC_UPDATED an den erweiterbaren Switchtreiberstapel aus. Diese OID-Anforderung benachrichtigt zugrunde liegende erweiterbare Switcherweiterungen über die Aktualisierung der Parameter eines Netzwerkadapters. Die OID wird nur für NiCs ausgestellt, die bereits verbunden wurden und noch nicht mit dem Trennvorgang begonnen haben. Diese Änderungen an der Laufzeitkonfiguration können NicFriendlyName, NetCfgInstanceId, MTU, NumaNodeId, PermanentMacAddress, VMMacAddress, CurrentMacAddress und VFAssigned umfassen.
Das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf eine NDIS_SWITCH_NIC_PARAMETERS-Struktur .
Bemerkungen
Der PortId-Member der NDIS_SWITCH_NIC_PARAMETERS-Struktur gibt den Port an, für den die Updatebenachrichtigung erstellt wird. Die erweiterbare Switcherweiterung kann die Parameterinformationen für diesen und andere Ports auf dem erweiterbaren Switch abrufen, indem OID-Abfrageanforderungen von OID_SWITCH_PORT_ARRAY ausgegeben werden.
Der Index-Member der NDIS_SWITCH_NIC_PARAMETERS-Struktur gibt den Index eines Netzwerkadapters an, für den die Updatebenachrichtigung erfolgt. Der Netzwerkadapter mit dem angegebenen Indexwert ist mit dem erweiterbaren Switchport verbunden, der vom PortId-Element angegeben wird. Weitere Informationen zu diesen Indexwerten finden Sie unter Indexwerte für Netzwerkadapter.
Die Erweiterung muss die folgenden Richtlinien für die Verarbeitung von OID-Satzanforderungen von OID_SWITCH_NIC_UPDATED befolgen:
- Die Erweiterung darf die NDIS_SWITCH_NIC_PARAMETERS Struktur, die der OID-Anforderung zugeordnet ist, nicht ändern.
- Die Erweiterung muss diese OID-Set-Anforderung immer an zugrunde liegende Erweiterungen weiterleiten. Die Erweiterung darf die Anforderung nicht abschließen.
- Die Erweiterung darf keine eigenen OID-Satzanforderungen von OID_SWITCH_NIC_UPDATED ausgeben.
Zurückgeben von Statuscodes
Der zugrunde liegende Miniportrand des erweiterbaren Schalters schließt die OID-Abfrageanforderung von OID_SWITCH_NIC_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) |