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) |