Freigeben über


OID_SWITCH_NIC_ARRAY

Eine Hyper-V erweiterbare Switcherweiterung stellt eine OID-Abfrageanforderung (Object Identifier) 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 auf das erste 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 Switchs den NumElements Member der NDIS_SWITCH_NIC_ARRAY Struktur auf Null fest. In diesem Fall werden keine NDIS_SWITCH_NIC_PARAMETERS Strukturen zurückgegeben.

Bemerkungen

Die OID_SWITCH_NIC_ARRAY OID darf nur ausgegeben werden, wenn die aktivierung des Hyper-V erweiterbaren Schalters abgeschlossen ist. Weitere Informationen finden Sie unter Abfragen der Hyper-V Extensible Switch Configuration.

Wenn die erweiterung die zurückgegebene NDIS_SWITCH_NIC_PARAMETERS Struktur verarbeitet, darf nicht davon ausgegangen werden, dass die verschiedenen Zeichenfolgenmmber der NDIS_SWITCH_PORT_PARAMETERS-Struktur, z. B. NicFriendlyName, NULL-beendet sind. Die Datentypen für diese Zeichenfolgenmmber werden durch die IF_COUNTED_STRING Struktur definiert. Der Treiber muss die Zeichenfolgenlänge aus dem Wert des Length Member dieser Struktur bestimmen.

Hinweis Wenn die Zeichenfolge null beendet ist, darf das element Length das endende Nullzeichen nicht enthalten.

Rückgabestatuscodes

Der zugrunde liegende Miniportrand des erweiterbaren Schalters schließt die OID-Abfrageanforderung von OID_SWITCH_NIC_ARRAY ab und gibt einen der folgenden Statuscodes 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 die NDIS_SWITCH_NIC_ARRAY und dessen Array von NDIS_SWITCH_NIC_PARAMETERS Elementen zurückzugeben. Der zugrunde liegende Miniportrand des erweiterbaren Schalters legt den DATA fest. QUERY_INFORMATION. BytesNeededed Member in der NDIS_OID_REQUEST Struktur auf die erforderliche Mindestpuffergröße.

NDIS_STATUS_FAILURE

Fehler bei der Anforderung aus anderen Gründen.

Anforderungen

Version

Unterstützt in NDIS 6.30 und höher.

Kopfball

Ntddndis.h (include Ndis.h)

Siehe auch


NDIS_OID_REQUEST

NDIS_SWITCH_NIC_ARRAY

NDIS_SWITCH_NIC_PARAMETERS

Abfragen der Hyper-V Extensible Switch Configuration