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:
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) |