Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Ein übermäßiger Treiber oder eine Benutzermodusanwendung gibt eine OID-Abfrageanforderung (Object Identifier) 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 einer erfolgreichen 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 keine NIC-Switches aufweist, legt der Treiber das NumElements Member der NDIS_NIC_SWITCH_INFO_ARRAY-Struktur auf Null fest, und es werden keine NDIS_NIC_SWITCH_INFO Strukturen zurückgegeben.
Bemerkungen
Übermäßig viele Treiber und Anwendungen im Benutzermodus stellen OID-Abfrageanforderungen von OID_NIC_SWITCH_ENUM_SWITCHES aus, um die auf einem Netzwerkadapter erstellten NIC-Switches auflisten zu können.
Hinweis Ab Windows Server 2012 unterstützt die einzelne I/O-Virtualisierungsschnittstelle (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 durch den Bezeichner von NDIS_DEFAULT_SWITCH_ID verwiesen wird.
Rückgabestatuscodes
NDIS behandelt die OID-Abfrageanforderung der OID_NIC_SWITCH_ENUM_SWITCHES Anforderung für Miniporttreiber. Die Treiber werden diese OID-Anforderung nicht ausgestellt.
Wenn NDIS die OID_NIC_SWITCH_ENUM_SWITCHES Anforderung verarbeitet, gibt sie einen der folgenden Statuscodes zurück.
| Statuscode | Beschreibung |
|---|---|
NDIS_STATUS_SUCCESS |
Die OID-Anforderung wurde erfolgreich abgeschlossen. |
NDIS_STATUS_NOT_SUPPORTED |
Der Miniporttreiber unterstützt weder die SR-IOV Schnittstelle noch ist die Verwendung der Schnittstelle aktiviert. |
NDIS_STATUS_INVALID_PARAMETER |
Mindestens ein Element der NDIS_NIC_SWITCH_INFO_ARRAY-Struktur hat ungültige Werte. |
NDIS_STATUS_INVALID_LENGTH |
Der Informationspuffer war zu kurz. NDIS legt die 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) |