OID_NIC_SWITCH_CURRENT_CAPABILITIES
Ein übersteigender Treiber gibt eine OID-Abfrageanforderung (Object Identifier) von OID_NIC_SWITCH_CURRENT_CAPABILITIES aus, um die derzeit aktivierten Hardwarefunktionen des NIC-Switches in einem 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
Ab NDIS 6.20 stellen Miniporttreiber die derzeit aktivierten NIC-Switch-Hardwarefunktionen auf dem Netzwerkadapter 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 CurrentNicSwitchCapabilities-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 aktivierten Hardwarefunktionen des NIC-Switches registrieren. Treiber registrieren diese Funktionen, indem sie NdisMSetMiniportAttributes aufrufen.
Overlying-Protokoll- und Filtertreiber müssen keine OID-Abfrageanforderungen von OID_NIC_SWITCH_CURRENT_CAPABILITIES ausgeben. NDIS stellt die derzeit aktivierten NIC Switch-Hardwarefunktionen eines Netzwerkadapters auf folgende Weise für diese Treiber bereit:
NDIS meldet die derzeit aktivierten NIC-Switchhardwarefunktionen eines zugrunde liegenden Netzwerkadapters, um während des Bindungsvorgangs im NicSwitchCapabilities-Member der NDIS_BIND_PARAMETERS-Struktur über die Protokolltreiber zu verfügen.
NDIS meldet die derzeit aktivierten NIC-Switch-Hardwarefunktionen eines zugrunde liegenden Netzwerkadapters, um während des Anfügens die Filtertreiber im NicSwitchCapabilities-Member der NDIS_FILTER_ATTACH_PARAMETERS-Struktur zu übersteigen.
Zurückgeben von Statuscodes
NDIS verarbeitet die OID-Abfrageanforderung der OID_NIC_SWITCH_CURRENT_CAPABILITIES-Anforderung für Miniporttreiber. Die Treiber erhalten diese OID-Anforderung nicht.
Wenn NDIS die OID_NIC_SWITCH_CURRENT_CAPABILITIES-Anforderung verarbeitet, gibt es 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). Der Miniporttreiber muss die DATEN festlegen. 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) |