Abfragen der Hyper-V Extensible Switch-Konfiguration

Die Hyper-V-erweiterbare Switchschnittstelle enthält Objektbezeichneranforderungen (Object Identifier, OID), die von einer erweiterbaren Switcherweiterung ausgegeben werden, um die aktuelle Konfiguration des erweiterbaren Switchs, seiner Ports und seiner Netzwerkadapterverbindungen abzufragen. Zu diesen Anforderungen gehören die folgenden OIDs:

OID_SWITCH_NIC_ARRAY
Diese OID-Abfrageanforderung gibt ein Array zurück. Jedes Element im Array gibt die Konfigurationsparameter eines Netzwerkadapters an, der einem erweiterbaren Switchport zugeordnet ist.

OID_SWITCH_PARAMETERS
Diese OID-Abfrageanforderung gibt die aktuelle Konfiguration des erweiterbaren Switches zurück.

OID_SWITCH_PORT_ARRAY
Diese OID-Abfrageanforderung gibt ein Array zurück. Jedes Element im Array gibt die Konfigurationsparameter für einen erweiterbaren Switchport an.

OID_SWITCH_PORT_PROPERTY_ENUM
Diese OID-Methodenanforderung gibt ein Array zurück. Jedes Element im Array gibt die Eigenschaften einer Richtlinie für einen angegebenen erweiterbaren Switchport an.

OID_SWITCH_PROPERTY_ENUM
Diese OID-Methodenanforderung gibt ein Array zurück. Jedes Element im Array gibt die Eigenschaften einer erweiterbaren Switchrichtlinie an.

Hinweis Wenn eine Switch-Erweiterung für einen Hyper-v Extensible Switch bindet, muss sie zuerst die OID_SWITCH_PARAMETERS OID ausgeben, um die grundlegenden Switchinformationen abzurufen. Wenn das IsActive-Element der NDIS_SWITCH_PARAMETERS-Struktur FALSCH ist, darf die Erweiterung die anderen Abfrage-OIDs erst ausstellen, wenn der Switch die Aktivierung abgeschlossen hat. In diesem Fall gibt die NetEventSwitchActivate-NET_PNP_EVENT-Benachrichtigung das Switchaktivierungsereignis an. Wenn das IsActive-Element bei der Bindung WAHR ist, kann die Erweiterung die anderen Abfrage-OIDs sicher ausstellen. Die Abfrage der Konfiguration, während der Hyper-v Extensible Switch die Aktivierung nicht abgeschlossen hat, führt dazu, dass die Erweiterung eine unvollständige anfängliche Ansicht der Switchkonfiguration aufweist.

Hinweis : Wenn eine Erweiterung eigene OID-Anforderungen generiert, erfolgt dies auf die gleiche Weise wie jeder NDIS-Filtertreiber. Weitere Informationen dazu, wie dies geschieht, finden Sie unter Generieren von OID-Anforderungen aus einem NDIS-Filtertreiber.

Weitere Informationen zum Steuerelementpfad für erweiterbare Switch-OID-Anforderungen finden Sie unter Hyper-V Extensible Switch Control Path for OID Requests.