Freigeben über


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:

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)

Weitere Informationen


NDIS_NIC_SWITCH_INFO

NDIS_NIC_SWITCH_INFO_ARRAY

NDIS_OID_REQUEST

OID_NIC_SWITCH_CREATE_SWITCH

OID_NIC_SWITCH_PARAMETERS