Auflisten von NIC-Switches auf einem Netzwerkadapter
Ein übermäßiger Treiber oder eine Benutzeranwendung kann eine Liste aller NIC-Switches abrufen, die auf einem Netzwerkadapter erstellt wurden, der die Einzelstamm-E/A-Virtualisierung (SINGLE Root I/O Virtualization, SR-IOV) unterstützt. Der Treiber oder die Anwendung gibt eine OID-Abfrageanforderung (Object Identifier) von OID_NIC_SWITCH_ENUM_SWITCHES aus, um diese Liste abzurufen.
Nach einer erfolgreichen Rückgabe von dieser OID-Anforderung enthält der InformationBuffer-Member 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.
Hinweis Ab Windows Server 2012 unterstützt die SR-IOV-Schnittstelle nur einen NIC-Switch auf dem Netzwerkadapter. Dieser Switch wird als Standard-NIC-Switch bezeichnet und vom bezeichner NDIS_DEFAULT_SWITCH_ID referenziert.
NDIS verarbeitet die OID_NIC_SWITCH_ENUM_SWITCHES Anforderung für Miniporttreiber. NDIS gibt die Informationen aus einem internen Cache der Daten zurück, die es aus den folgenden Quellen verwaltet:
Die standardisierte SR-IOV-Schlüsselwort (keyword) Einstellungen in der Registrierung. Weitere Informationen zu diesen Schlüsselwörtern finden Sie unter Standardisierte INF-Schlüsselwörter für SR-IOV.
OID-Anforderungen von OID_NIC_SWITCH_CREATE_SWITCH und OID_NIC_SWITCH_PARAMETERS.
Hinweis NDIS stellt auch die Enumeration der Switches im NicSwitchArray-Member in den NDIS_BIND_PARAMETERS - und NDIS_FILTER_ATTACH_PARAMETERS-Strukturen bereit. Daher müssen die überstehenden Protokoll- und Filtertreiber keine OID_NIC_SWITCH_ENUM_SWITCHES Anforderungen ausgeben, um diese Informationen zu erhalten.