Abfragen der Konfiguration des erweiterbaren Hyper-V-Switches

Die erweiterbare Hyper-V-Switch-Schnittstelle enthält Objektbezeichneranforderungen (OID), die von einer erweiterbaren Switcherweiterung ausgegeben werden, um die aktuelle Konfiguration des erweiterbaren Switches, seiner Ports und seiner Netzwerkadapterverbindungen abzufragen. Diese Anforderungen umfassen 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 Anforderung der OID-Methode 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 Anforderung der OID-Methode gibt ein Array zurück. Jedes Element im Array gibt die Eigenschaften einer erweiterbaren Switchrichtlinie an.

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

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

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