OID_NIC_SWITCH_VPORT_PARAMETERS

Artikel
06/15/2023

Ein überlastender Treiber kann die Parameter für einen virtuellen Port (VPort) auf einem NIC-Switch abrufen, der auf einem Netzwerkadapter erstellt wurde, der die Einzelstamm-E/A-Virtualisierung (Single Root I/O Virtualization, SR-IOV) unterstützt. Der Treiber gibt eine OID-Methodenanforderung (Object Identifier) von OID_NIC_SWITCH_VPORT_PARAMETERS aus, um diese Parameter abzurufen.

Übergeordnete Treiber geben eine OID-Set-Anforderung von OID_NIC_SWITCH_VPORT_PARAMETERS aus, um die Konfigurationsparameter eines angegebenen VPorts festzulegen, der an den NIC-Switch des Netzwerkadapters angefügt ist. 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_VPORT_PARAMETERS-Struktur .

Der übersteigende Treiber gibt den VPort für die OID-Methode oder die Set-Anforderung an, indem der VPortId-Member der NDIS_NIC_SWITCH_VPORT_PARAMETERS-Struktur auf den bezeichner festgelegt wird, der dem VPort zugeordnet ist. Der überlastende Treiber ruft den VPort-Bezeichner auf eine der folgenden Arten ab:

Aus einer vorherigen OID-Methodenanforderung von OID_NIC_SWITCH_CREATE_VPORT.
Aus einer vorherigen OID-Methodenanforderung von OID_NIC_SWITCH_ENUM_VPORTS.

Bemerkungen

OID_NIC_SWITCH_VPORT_PARAMETERS kann entweder in OID-Methodenanforderungen oder OID-Set-Anforderungen verwendet werden.

Behandeln von OID-Methodenanforderungen von OID_NIC_SWITCH_VPORT_PARAMETERS

Übergeordnete Treiber stellen eine OID-Methodenanforderung von OID_NIC_SWITCH_VPORT_PARAMETERS aus, um die aktuellen Konfigurationsparameter eines VPorts abzufragen, der an den NIC-Switch des Netzwerkadapters angefügt ist. Übergehende Treiber geben den abzufragenden VPort an, indem der VPortId-Member der NDIS_NIC_SWITCH_VPORT_PARAMETERS-Struktur auf den VPort-Bezeichner festgelegt wird.

NDIS verarbeitet die OID-Methodenanforderung von OID_NIC_SWITCH_VPORT_PARAMETERS für Miniporttreiber. NDIS gibt Informationen zurück, die sie von früheren OID-Anforderungen von OID_NIC_SWITCH_CREATE_VPORT und OID_NIC_SWITCH_ENUM_VPORTS erhalten hat.

Nach einer erfolgreichen Rückgabe von der OID-Methodenanforderung enthält der InformationBuffer-Member der NDIS_OID_REQUEST-Struktur einen Zeiger auf eine NDIS_NIC_SWITCH_VPORT_PARAMETERS-Struktur . Diese Struktur enthält die Konfigurationsparameter für den angegebenen Switch.

Weitere Informationen finden Sie unter Abfragen der Parameter eines virtuellen Ports.

Behandeln von OID-Set-Anforderungen von OID_NIC_SWITCH_VPORT_PARAMETERS

Übergeordnete Treiber geben eine OID-Set-Anforderung von OID_NIC_SWITCH_VPORT_PARAMETERS aus, um die aktuellen Konfigurationsparameter eines VPorts zu ändern, der an den NIC-Switch eines Netzwerkadapters angefügt ist. Diese OID-Anforderung kann verwendet werden, um die Parameter für standard- und nicht standardmäßige VPorts zu aktualisieren.

Es kann nur eine begrenzte Teilmenge der Konfigurationsparameter für einen VPort geändert werden. Der überstehende Treiber gibt den zu ändernden Parameter an, indem die folgenden Member der NDIS_NIC_SWITCH_VPORT_PARAMETERS-Struktur festgelegt werden:

Das VPortId-Element wird auf den Bezeichner des VPorts festgelegt, dessen Parameter geändert werden.
Die entsprechenden NDIS_NIC_SWITCH_VPORT_PARAMETERS_Xxx_CHANGED-Flags werden im Flags-Element festgelegt. Member der NDIS_NIC_SWITCH_VPORT_PARAMETERS-Struktur können nur geändert werden, wenn ein entsprechendes flag NDIS_NIC_SWITCH_PARAMETERS_Xxx_CHANGED in Ntddndis.h definiert ist.
Die entsprechenden Member der NDIS_NIC_SWITCH_VPORT_PARAMETERS-Struktur werden mit den zu ändernden VPort-Konfigurationsparametern festgelegt.

Nachdem der PF-Miniporttreiber die OID-Set-Anforderung von OID_NIC_SWITCH_VPORT_PARAMETERS empfangen hat, konfiguriert der Treiber die Hardware mit den Konfigurationsparametern. Der Treiber kann nur die Konfigurationsparameter ändern, die durch NDIS_NIC_SWITCH_VPORT_PARAMETERS_Xxx_CHANGED flags im Flags-Member der NDIS_NIC_SWITCH_VPORT_PARAMETERS-Struktur identifiziert werden.

Weitere Informationen finden Sie unter Festlegen der Parameter eines virtuellen Ports.

Zurückgeben von Statuscodes

NDIS oder der PF-Miniporttreiber gibt den folgenden status Code für festgelegte oder Methoden-OID-Anforderungen von OID_NIC_SWITCH_VPORT_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_VPORT_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_FAILURE	Die Anforderung ist aus anderen Gründen fehlgeschlagen.