OID_NIC_SWITCH_PARAMETERS

Artikel
06/15/2023

Ein übersteigender Treiber gibt eine OID-Methodenanforderung (Object Identifier) von OID_NIC_SWITCH_PARAMETERS aus, um die aktuellen Konfigurationsparameter eines angegebenen NIC-Switches auf einem Netzwerkadapter abzurufen. NDIS verarbeitet diese Anforderungen der OID-Methode für den Miniporttreiber.

Überlastende Treiber geben eine OID-Set-Anforderung von OID_NIC_SWITCH_PARAMETERS aus, um die Konfigurationsparameter eines angegebenen NIC-Switches auf einem Netzwerkadapter festzulegen. Diese Anforderungen für den OID-Satz werden an den Miniporttreiber des PCI Express (PCIe) Physical Function (PF) des Netzwerkadapters ausgegeben. Diese OID-Setanforderungen sind für PF-Miniporttreiber erforderlich, die die SR-IOV-Schnittstelle (Single Root I/O Virtualization) unterstützen.

Das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf eine NDIS_NIC_SWITCH_PARAMETERS-Struktur .

Der übersteigende Treiber gibt den NIC-Switch für die OID-Methode oder die Set-Anforderung an, indem der SwitchId-Member der NDIS_NIC_SWITCH_PARAMETERS-Struktur auf den Switchbezeichner festgelegt wird. Der überlastende Treiber ruft den Switchbezeichner über eine der folgenden Methoden ab:

Aus einer vorherigen OID-Methodenanforderung von OID_NIC_SWITCH_ENUM_SWITCHES.
Aus dem NicSwitchArray-Element der NDIS_BIND_PARAMETERS-Struktur . NDIS übergibt einen Zeiger auf diese Struktur im BindParameters-Parameter der ProtocolBindAdapterEx-Funktion .
Aus dem NicSwitchArray-Element der NDIS_FILTER_ATTACH_PARAMETERS-Struktur . NDIS übergibt einen Zeiger auf diese Struktur im AttachParameters-Parameter der FilterAttach-Funktion .

Hinweis Ab Windows Server 2012 unterstützt Windows nur den Standard-NIC-Switch auf dem Netzwerkadapter. Der SwitchId-Member der NDIS_NIC_SWITCH_PARAMETERS-Struktur muss auf NDIS_DEFAULT_SWITCH_ID festgelegt werden.

Bemerkungen

Der überlastende Treiber gibt OID_NIC_SWITCH_PARAMETERS Anforderungen wie folgt aus:

Der übersteigende Treiber gibt eine OID-Methodenanforderung von OID_NIC_SWITCH_PARAMETERS aus, um die aktuellen Parameter eines angegebenen NIC-Switches abzurufen. Weitere Informationen finden Sie unter Abfragen der Parameter eines NIC-Switches.

Hinweis NDIS verarbeitet OID-Methodenanforderungen von OID_NIC_SWITCH_PARAMETERS für den PF-Miniporttreiber.
Der übersteigende Treiber gibt eine OID-Set-Anforderung von OID_NIC_SWITCH_PARAMETERS aus, um die aktuellen Parameter eines angegebenen NIC-Switches zu ändern. Weitere Informationen finden Sie unter Festlegen der Parameter eines NIC-Switches.

Hinweis Der PF-Miniporttreiber verarbeitet OID-Mengenanforderungen von OID_NIC_SWITCH_PARAMETERS.

Zurückgeben von Statuscodes

NDIS oder der PF-Miniporttreiber gibt die folgenden status Codes für festgelegte oder Methoden-OID-Anforderungen von OID_NIC_SWITCH_PARAMETERS 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 PF-Miniporttreiber unterstützt entweder nicht die SR-IOV-Schnittstelle (Single Root E/O Virtualization) oder ist für die Verwendung der Schnittstelle nicht aktiviert.
NDIS_STATUS_INVALID_PARAMETER	Mindestens ein Member der NDIS_NIC_SWITCH_PARAMETERS-Struktur hat ungültige Werte.
NDIS_STATUS_INVALID_LENGTH	Der Informationspuffer war zu kurz. NDIS oder der PF-Miniporttreiber legt die DATEN fest. METHOD_INFORMATION. BytesNeeded-Member (für OID-Methodenanforderungen) oder DATA. SET_INFORMATION. BytesNeeded-Member (für OID-Set-Anforderungen) in der NDIS_OID_REQUEST-Struktur auf die erforderliche Mindestpuffergröße.
NDIS_STATUS_REINIT_REQUIRED	Der PF-Miniporttreiber erfordert eine Neuinitialisierung des Netzwerkadapters, um die Änderungen auf den NIC-Switch anzuwenden.
NDIS_STATUS_FAILURE	Die Anforderung ist aus anderen Gründen fehlgeschlagen.