OID_NIC_SWITCH_HARDWARE_CAPABILITIES
Ein übersteigender Treiber gibt eine OID-Abfrageanforderung (Object Identifier) von OID_NIC_SWITCH_HARDWARE_CAPABILITIES aus, um die Hardwarefunktionen des NIC-Switches im Netzwerkadapter abzurufen.
Nach einer erfolgreichen Rückgabe von der OID-Abfrageanforderung enthält der InformationBuffer-Member der NDIS_OID_REQUEST-Struktur einen Zeiger auf eine NDIS_NIC_SWITCH_CAPABILITIES-Struktur .
Bemerkungen
Die NDIS_NIC_SWITCH_CAPABILITIES-Struktur enthält Informationen zu den Hardwarefunktionen eines NIC-Switches auf dem Netzwerkadapter. Diese Funktionen können die Hardwarefunktionen enthalten, die derzeit durch die INF-Dateieinstellungen oder über die Seite Erweiterte Eigenschaften deaktiviert sind.
Hinweis Alle Funktionen des angegebenen NIC-Switches werden über eine OID-Abfrageanforderung von OID_NIC_SWITCH_HARDWARE_CAPABILITIES zurückgegeben, unabhängig davon, ob eine Funktion aktiviert oder deaktiviert ist.
Ab NDIS 6.20 stellen Miniporttreiber die Hardwarefunktionen des NIC-Switches bereit, wenn die MiniportInitializeEx-Funktion aufgerufen wird. Der Treiber initialisiert eine NDIS_NIC_SWITCH_CAPABILITIES-Struktur mit den Hardwarefunktionen des NIC-Switches und legt den HardwareNicSwitchCapabilities-Member der NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES-Struktur auf einen Zeiger auf die NDIS_NIC_SWITCH_CAPABILITIES-Struktur fest. Der Miniporttreiber ruft dann die NdisMSetMiniportAttributes-Funktion auf und legt den MiniportAttributes-Parameter auf einen Zeiger auf eine NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES-Struktur fest.
Hinweis Ab NDIS 6.30 müssen Miniporttreiber, die die SR-IOV-Schnittstelle (Single Root E/O Virtualization) unterstützen, die Hardwarefunktionen des NIC-Switches registrieren. Treiber registrieren diese Funktionen, indem sie NdisMSetMiniportAttributes aufrufen.
Zurückgeben von Statuscodes
NDIS verarbeitet die OID-Abfrageanforderung von OID_NIC_SWITCH_HARDWARE_CAPABILITIES Anforderung für Miniporttreiber und gibt einen der folgenden status Codes zurück:
| Statuscode | BESCHREIBUNG |
|---|---|
NDIS_STATUS_SUCCESS |
Die Anforderung wurde erfolgreich abgeschlossen. Der InformationBuffer verweist auf eine NDIS_NIC_SWITCH_CAPABILITIES-Struktur . |
NDIS_STATUS_NOT_SUPPORTED |
Der Miniporttreiber unterstützt entweder nicht die SR-IOV-Schnittstelle (Single Root I/O Virtualization) oder ist nicht für die Verwendung der Schnittstelle aktiviert. |
NDIS_STATUS_INVALID_LENGTH |
Die Länge des Informationspuffers ist kleiner als sizeof(NDIS_NIC_SWITCH_CAPABILITIES). NDIS legt die DATEN fest. QUERY_INFORMATION. BytesNeeded-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.20 und höher. |
Header |
Ntddndis.h (include Ndis.h) |