Freigeben über


OID_NIC_SWITCH_PARAMETERS

Ein übermäßiger 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 OID-Methodenanforderungen für den Miniporttreiber.

Beim Überstellen von Treibern wird eine OID-Setanforderung von OID_NIC_SWITCH_PARAMETERS zum Festlegen der Konfigurationsparameter eines angegebenen NIC-Switches auf einem Netzwerkadapter angezeigt. Diese OID-Setanforderungen werden an den Miniporttreiber der PCI Express (PCIe) Physical Function (PF) des Netzwerkadapters ausgegeben. Diese OID-Setanforderungen sind für PF-Miniporttreiber erforderlich, die die einzelne I/O-Virtualisierungsschnittstelle (SR-IOV) unterstützen.

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

Der Überlauftreiber gibt den NIC-Schalter für die OID-Methode an oder legt die Anforderung fest, indem die SwitchId Member der NDIS_NIC_SWITCH_PARAMETERS Struktur auf den Switchbezeichner festgelegt wird. Der übersteigende Treiber ruft den Switchbezeichner auf eine der folgenden Arten ab:

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

Bemerkungen

Der übersteigende 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-Schalters abzurufen. Weitere Informationen finden Sie unter Abfragen der Parameter eines NIC-Schalters.

    Hinweis NDIS verarbeitet OID-Methodenanforderungen von OID_NIC_SWITCH_PARAMETERS für den PF-Miniporttreiber.

  • Der übersteigende Treiber gibt eine OID-Setanforderung von OID_NIC_SWITCH_PARAMETERS aus, um die aktuellen Parameter eines angegebenen NIC-Schalters zu ändern. Weitere Informationen finden Sie unter Festlegen der Parameter eines NIC-Schalters.

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

Rückgabestatuscodes

NDIS oder der PF Miniport-Treiber gibt die folgenden Statuscodes für Set- oder Methoden-OID-Anforderungen von OID_NIC_SWITCH_PARAMETERS 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 PF-Miniporttreiber unterstützt weder die einzelne I/O-Virtualisierungsschnittstelle (SR-IOV) noch ist die Verwendung der Schnittstelle aktiviert.

NDIS_STATUS_INVALID_PARAMETER

Mindestens ein Element der NDIS_NIC_SWITCH_PARAMETERS-Struktur hat ungültige Werte.

NDIS_STATUS_INVALID_LENGTH

Der Informationspuffer war zu kurz. NDIS oder der PF Miniport-Treiber legt den DATA fest. METHOD_INFORMATION. BytesNeeded Member (für OID-Methodenanforderungen) oder DATA. SET_INFORMATION. BytesNeeded Member (für OID-Setanforderungen) in der NDIS_OID_REQUEST Struktur auf die erforderliche Mindestpuffergröße.

NDIS_STATUS_REINIT_REQUIRED

Der PF-Miniporttreiber erfordert eine Erneuteitialisierung des Netzwerkadapters, um die Änderungen auf den NIC-Switch anzuwenden.

NDIS_STATUS_FAILURE

Fehler bei der Anforderung aus anderen Gründen.

Anforderungen

Version

Unterstützt in NDIS 6.30 und höher.

Kopfball

Ntddndis.h (include Ndis.h)

Siehe auch


FilterAttach-

NDIS_BIND_PARAMETERS

NDIS_FILTER_ATTACH_PARAMETERS

NDIS_NIC_SWITCH_PARAMETERS

NDIS_OID_REQUEST

OID_NIC_SWITCH_CREATE_SWITCH

OID_NIC_SWITCH_ENUM_SWITCHES

ProtocolBindAdapterEx-