Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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:
Aus einer vorherigen OID-Methodenanforderung von OID_NIC_SWITCH_ENUM_SWITCHES.
Aus dem NicSwitchArray- Mitglied der NDIS_BIND_PARAMETERS-Struktur. NDIS übergibt einen Zeiger an diese Struktur im BindParameters Parameter der ProtocolBindAdapterEx--Funktion.
Aus dem NicSwitchArray Mitglied der NDIS_FILTER_ATTACH_PARAMETERS-Struktur. NDIS übergibt einen Zeiger an diese Struktur im AttachParameters Parameter der funktion FilterAttach.
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) |