Freigeben über


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)

Siehe auch

NDIS_BIND_PARAMETERS

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NDIS_NIC_SWITCH_CAPABILITIES

NDIS_OID_REQUEST