OID_NIC_SWITCH_PARAMETERS
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. |
Requirements (Anforderungen)
Version |
Unterstützt in NDIS 6.30 und höher. |
Header |
Ntddndis.h (include Ndis.h) |