OID_NIC_SWITCH_VPORT_PARAMETERS

Artikel
03/13/2025

Ein übermäßiger Treiber kann die Parameter für einen virtuellen Port (VPort) auf einem NIC-Switch abrufen, der auf einem Netzwerkadapter erstellt wurde, der einzelne E/A-Virtualisierung (SR-IOV) unterstützt. Der Treiber gibt eine OID-Methodenanforderung (Object Identifier) von OID_NIC_SWITCH_VPORT_PARAMETERS aus, um diese Parameter abzurufen.

Beim Überstellen von Treibern wird eine OID-Satzanforderung von OID_NIC_SWITCH_VPORT_PARAMETERS aus, um die Konfigurationsparameter eines angegebenen VPorts festzulegen, der an den NIC-Switch des Netzwerkadapters angeschlossen ist. 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_VPORT_PARAMETERS Struktur.

Der Überlauftreiber gibt den VPort für die OID-Methode oder die Set-Anforderung an, indem die VPortId Member der NDIS_NIC_SWITCH_VPORT_PARAMETERS-Struktur auf den dem VPort zugeordneten Bezeichner festgelegt wird. Der übersteigende 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 können entweder in OID-Methodenanforderungen oder OID-Set-Anforderungenverwendet werden.

Behandlung von OID-Methodenanforderungen von OID_NIC_SWITCH_VPORT_PARAMETERS

Beim Überstellen von Treibern wird 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. Durch das Überstellen von Treibern wird der zu abfragende VPort angegeben, indem sie das VPortId- Mitglied der NDIS_NIC_SWITCH_VPORT_PARAMETERS-Struktur auf den VPort-Bezeichner festlegen.

NDIS verarbeitet die OID-Methodenanforderung von OID_NIC_SWITCH_VPORT_PARAMETERS für Miniporttreiber. NDIS gibt Informationen zurück, die sie aus vorherigen OID-Anforderungen von OID_NIC_SWITCH_CREATE_VPORT und OID_NIC_SWITCH_ENUM_VPORTSerhalten hat.

Nach einer erfolgreichen Rückgabe der OID-Methodenanforderung enthält das InformationBuffer Element 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 Port.

Behandlung von OID-Set-Anforderungen von OID_NIC_SWITCH_VPORT_PARAMETERS

Beim Überstellen von Treibern wird eine OID-Satzanforderung von OID_NIC_SWITCH_VPORT_PARAMETERS zum Ändern der aktuellen Konfigurationsparameter eines VPorts, der an den NIC-Switch eines Netzwerkadapters angeschlossen ist, ausgelöst. 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 von Konfigurationsparametern für einen VPort geändert werden. Der Überlauftreiber gibt den zu ändernden Parameter an, indem die folgenden Member der NDIS_NIC_SWITCH_VPORT_PARAMETERS-Struktur festgelegt werden:

Der VPortId Member wird auf den Bezeichner des VPort festgelegt, dessen Parameter geändert werden.
Die entsprechenden NDIS_NIC_SWITCH_VPORT_PARAMETERS_Xxx_CHANGED Flags werden im Flags Member festgelegt. Elemente der NDIS_NIC_SWITCH_VPORT_PARAMETERS-Struktur können nur geändert werden, wenn ein entsprechendes NDIS_NIC_SWITCH_PARAMETERS_Xxx-_CHANGED Flag 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 Miniport-Treiber die OID-Setanforderung von OID_NIC_SWITCH_VPORT_PARAMETERS empfängt, konfiguriert der Treiber die Hardware mit den Konfigurationsparametern. Der Treiber kann diese Konfigurationsparameter nur ändern, die durch NDIS_NIC_SWITCH_VPORT_PARAMETERS_Xxx-_CHANGED Flags im Flags Mitglied der NDIS_NIC_SWITCH_VPORT_PARAMETERS-Struktur identifiziert werden.

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

Rückgabestatuscodes

NDIS oder der PF Miniport-Treiber gibt den folgenden Statuscode für set- oder method-OID-Anforderungen von OID_NIC_SWITCH_VPORT_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_VPORT_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_FAILURE	Fehler bei der Anforderung aus anderen Gründen.