OID_NIC_SWITCH_ENUM_SWITCHES

Artikel
06/15/2023

Eine überlastende Treiber- oder Benutzermodusanwendung stellt eine Objektbezeichnerabfrageanforderung (OID) von OID_NIC_SWITCH_ENUM_SWITCHES aus, um ein Array abzurufen. Jedes Element im Array gibt die Attribute eines NIC-Switches an, der auf einem Netzwerkadapter erstellt wurde.

Nach erfolgreicher Rückgabe dieser OID-Abfrageanforderung enthält das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur einen Zeiger auf einen Puffer, der Folgendes enthält:

Eine NDIS_NIC_SWITCH_INFO_ARRAY-Struktur , die die Anzahl der Elemente innerhalb des Arrays definiert.
Ein Array von NDIS_NIC_SWITCH_INFO Strukturen. Jede dieser Strukturen enthält die Informationen zu einem einzelnen NIC-Switch, der auf dem Netzwerkadapter erstellt wurde.

Hinweis Wenn der Netzwerkadapter über keine NIC-Switches verfügt, legt der Treiber den NumElements-Member der NDIS_NIC_SWITCH_INFO_ARRAY-Struktur auf Null fest, und es werden keine NDIS_NIC_SWITCH_INFO Strukturen zurückgegeben.

Bemerkungen

Überlastende Treiber und Benutzermodusanwendungen geben OID-Abfrageanforderungen von OID_NIC_SWITCH_ENUM_SWITCHES aus, um die auf einem Netzwerkadapter erstellten NIC-Switches aufzulisten.

Hinweis Ab Windows Server 2012 unterstützt die SINGLE-Root-E/A-Virtualisierungsschnittstelle (Single Root E/O Virtualization, SR-IOV) nur den Standard-NIC-Switch auf dem Netzwerkadapter. Daher muss die zurückgegebene NDIS_NIC_SWITCH_INFO_ARRAY-Struktur ein einzelnes NDIS_NIC_SWITCH_INFO-Element für den Standard-NIC-Switch angeben, auf den der Bezeichner von NDIS_DEFAULT_SWITCH_ID verweist.

Rückgabestatuscodes

NDIS verarbeitet die OID-Abfrageanforderung der OID_NIC_SWITCH_ENUM_SWITCHES Anforderung für Miniporttreiber. Die Treiber erhalten diese OID-Anforderung nicht.

Wenn NDIS die OID_NIC_SWITCH_ENUM_SWITCHES-Anforderung verarbeitet, gibt es einen der folgenden status-Codes zurück.

Statuscode	BESCHREIBUNG
NDIS_STATUS_SUCCESS	Die OID-Anforderung wurde erfolgreich abgeschlossen.
NDIS_STATUS_NOT_SUPPORTED	Der Miniporttreiber unterstützt entweder die SR-IOV-Schnittstelle nicht oder ist für die Verwendung der Schnittstelle nicht aktiviert.
NDIS_STATUS_INVALID_PARAMETER	Mindestens ein Member der NDIS_NIC_SWITCH_INFO_ARRAY-Struktur weisen ungültige Werte auf.
NDIS_STATUS_INVALID_LENGTH	Der Informationspuffer war zu kurz. NDIS legt die DATEN 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.