OID_SWITCH_NIC_ARRAY
Eine erweiterungsfähige Hyper-V-Switch-Erweiterung gibt eine Objektbezeichnerabfrageanforderung (Object Identifier, OID) von OID_SWITCH_NIC_ARRAY aus, um ein Array abzurufen. Jedes Element im Array gibt die Konfigurationsparameter eines virtuellen Netzwerkadapters an, der einem erweiterbaren Switchport zugeordnet ist.
Wenn die OID-Abfrageanforderung erfolgreich abgeschlossen wurde, enthält das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur einen Zeiger auf einen Puffer. Dieser Puffer enthält die folgenden Daten:
Eine NDIS_SWITCH_NIC_ARRAY-Struktur , die die Anzahl der Elemente im Array definiert. Diese Struktur gibt auch den Offset zum ersten Element im Array an.
Ein Array von NDIS_SWITCH_NIC_PARAMETERS Strukturen. Jede dieser Strukturen enthält Informationen zu einem Netzwerkadapter, der mit einem erweiterbaren Switchport verbunden ist.
Hinweis Wenn keine Netzwerkadapter mit erweiterbaren Switchports verbunden sind, legt der zugrunde liegende Miniportrand des erweiterbaren Switches das NumElements-Element der NDIS_SWITCH_NIC_ARRAY-Struktur auf 0 fest. In diesem Fall werden keine NDIS_SWITCH_NIC_PARAMETERS-Strukturen zurückgegeben.
Bemerkungen
Die OID_SWITCH_NIC_ARRAY OID darf nur ausgestellt werden, wenn der erweiterbare Hyper-V-Switch die Aktivierung abgeschlossen hat. Weitere Informationen finden Sie unter Abfragen der Hyper-V Extensible Switch-Konfiguration .
Wenn die Erweiterung die zurückgegebene NDIS_SWITCH_NIC_PARAMETERS Struktur verarbeitet, darf nicht davon ausgegangen werden, dass die verschiedenen Zeichenfolgenmember der NDIS_SWITCH_PORT_PARAMETERS-Struktur , z. B. NicFriendlyName, NULL-beendet sind. Die Datentypen für diese Zeichenfolgenmember werden von der IF_COUNTED_STRING-Struktur typdefiniert. Der Treiber muss die Zeichenfolgenlänge aus dem Wert des Length-Members dieser Struktur ermitteln.
Hinweis Wenn die Zeichenfolge null-beendet ist, darf das Length-Element das beendende NULL-Zeichen nicht enthalten.
Rückgabestatuscodes
Der zugrunde liegende Miniportrand des erweiterbaren Switches schließt die OID-Abfrageanforderung von OID_SWITCH_NIC_ARRAY ab und gibt einen der folgenden status-Codes zurück.
| Statuscode | BESCHREIBUNG |
|---|---|
NDIS_STATUS_SUCCESS |
Die OID-Anforderung wurde erfolgreich abgeschlossen. |
NDIS_STATUS_INVALID_LENGTH |
Die Länge des Informationspuffers ist zu klein, um den NDIS_SWITCH_NIC_ARRAY und sein Array von NDIS_SWITCH_NIC_PARAMETERS Elementen zurückzugeben. Der zugrunde liegende Miniportrand des erweiterbaren Switches legt die DATA fest . QUERY_INFORMATION. BytesNeed-Member in der NDIS_OID_REQUEST-Struktur auf die erforderliche Mindestpuffergröße. |
NDIS_STATUS_FAILURE |
Die Anforderung ist aus anderen Gründen fehlgeschlagen. |
Requirements (Anforderungen)
Version |
Unterstützt in NDIS 6.30 und höher. |
Header |
Ntddndis.h (include Ndis.h) |
Weitere Informationen
Abfragen der Konfiguration des erweiterbaren Hyper-V-Switches