OID_NIC_SWITCH_HARDWARE_CAPABILITIES
Ein übermäßiger 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 aus der OID-Abfrageanforderung enthält das InformationBuffer- Element 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 von den INF-Dateieinstellungen oder über die Eigenschaftenseite Advanced 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 liefern Miniporttreiber die Hardwarefunktionen des NIC-Schalters, wenn die MiniportInitializeEx- funktion aufgerufen wird. Der Treiber initialisiert eine NDIS_NIC_SWITCH_CAPABILITIES Struktur mit den Hardwarefunktionen des NIC-Switches und legt die HardwareNicSwitchCapabilities Element 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 einzelne I/O-Virtualisierung (SR-IOV)-Schnittstelle unterstützen, die Hardwarefunktionen des NIC-Switches registrieren. Treiber registrieren diese Funktionen durch Aufrufen von NdisMSetMiniportAttributes.
Rückgabestatuscodes
NDIS behandelt die OID-Abfrageanforderung OID_NIC_SWITCH_HARDWARE_CAPABILITIES Anforderung für Miniporttreiber und gibt einen der folgenden Statuscodes zurück:
Statuscode | Beschreibung |
---|---|
NDIS_STATUS_SUCCESS |
Die Anforderung wurde erfolgreich abgeschlossen. Die InformationBuffer- verweist auf eine NDIS_NIC_SWITCH_CAPABILITIES Struktur. |
NDIS_STATUS_NOT_SUPPORTED |
Der Miniporttreiber unterstützt weder die einzelne I/O-Virtualisierungsschnittstelle (SR-IOV) noch ist die Verwendung der Schnittstelle aktiviert. |
NDIS_STATUS_INVALID_LENGTH |
Die Länge des Informationspuffers ist kleiner als die Größe(NDIS_NIC_SWITCH_CAPABILITIES). 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.20 und höher. |
Kopfball |
Ntddndis.h (include Ndis.h) |