OID_NIC_SWITCH_ENUM_SWITCHES
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. |
Requirements (Anforderungen)
Version |
Unterstützt in NDIS 6.30 und höher. |
Header |
Ntddndis.h (include Ndis.h) |