NDIS_NIC_SWITCH_VPORT_INFO-Struktur (ntddndis.h)

Artikel
03/01/2024

Die NDIS_NIC_SWITCH_VPORT_INFO-Struktur gibt die Konfiguration für einen virtuellen Port (VPort) auf einem Netzwerkadapterswitch des Netzwerkadapters an.

Syntax

typedef struct _NDIS_NIC_SWITCH_VPORT_INFO {
  NDIS_OBJECT_HEADER                         Header;
  NDIS_NIC_SWITCH_VPORT_ID                   VPortId;
  ULONG                                      Flags;
  NDIS_NIC_SWITCH_ID                         SwitchId;
  NDIS_VPORT_NAME                            VPortName;
  NDIS_SRIOV_FUNCTION_ID                     AttachedFunctionId;
  ULONG                                      NumQueuePairs;
  NDIS_NIC_SWITCH_VPORT_INTERRUPT_MODERATION InterruptModeration;
  NDIS_NIC_SWITCH_VPORT_STATE                VPortState;
  GROUP_AFFINITY                             ProcessorAffinity;
  ULONG                                      LookaheadSize;
  ULONG                                      NumFilters;
} NDIS_NIC_SWITCH_VPORT_INFO, *PNDIS_NIC_SWITCH_VPORT_INFO;

Member

Header

Typ, Revision und Größe der NDIS_NIC_SWITCH_VPORT_INFO-Struktur . Dieser Member ist als NDIS_OBJECT_HEADER-Struktur formatiert.

Der Miniporttreiber muss das Type-Element von Header auf NDIS_OBJECT_TYPE_DEFAULT festlegen. Um die Version der NDIS_NIC_SWITCH_VPORT_INFO-Struktur anzugeben, muss der Treiber den Revisionsmember von Header auf den folgenden Wert festlegen:

NDIS_NIC_SWITCH_VPORT_INFO_REVISION_1

Originalversion für NDIS 6.30 und höher.

Legen Sie das Element Größe auf NDIS_SIZEOF_NIC_SWITCH_VPORT_INFO_REVISION_1 fest.

VPortId

Ein NDIS_NIC_SWITCH_VPORT_ID Wert, der den virtuellen Port (VPort) auf dem Netzwerkadapter eindeutig identifiziert.

Der Wert NDIS_DEFAULT_VPORT_ID gibt den Standard-VPort auf dem Switch an. Der Standard-VPort ist immer an die PHYSISCHE FUNKTION (PCIe) des Netzwerkadapters angefügt.

Hinweis Ein nicht standardmäßiger VPort mit dem angegebenen VPortId-Wert muss zuvor über eine OID-Methodenanforderung von OID_NIC_SWITCH_CREATE_VPORT erstellt worden sein.

Flags

Ein ULONG-Wert, der ein bitweises OR von Flags enthält. Dieser Member ist für NDIS reserviert.

SwitchId

Ein NDIS_NIC_SWITCH_ID Wert, der einen Netzwerkadapterswitch eindeutig identifiziert, der auf dem Netzwerkadapter erstellt wurde. Der über das VPortId-Element identifizierte VPort wird auf dem vom SwitchId-Element angegebenen Switch erstellt.

Der Switchbezeichner ist eine ganze Zahl zwischen null und der Anzahl von Switches, die vom Netzwerkadapter unterstützt werden. Der Wert NDIS_DEFAULT_SWITCH_ID gibt den Standard-Netzwerkadapterswitch an.

Hinweis Ab Windows Server 2012 unterstützt die SR-IOV-Schnittstelle (Single Root E/O Virtualization) nur den Standard-Netzwerkadapterswitch auf dem Netzwerkadapter. Der Wert dieses Members muss auf NDIS_DEFAULT_SWITCH_ID festgelegt werden.

VPortName

Ein NDIS_VPORT_NAME Wert, der den Namen des VPorts angibt, der auf dem Netzwerkadapterswitch erstellt wurde. Dieses Element enthält die benutzerfreundliche Beschreibung des VPorts.

AttachedFunctionId

Ein NDIS_SRIOV_FUNCTION_ID Wert, der den Bezeichner eines VF oder der PF angibt, an den der VPort angefügt ist.

Hinweis Wenn dieser Wert NDIS_PF_FUNCTION_ID ist, wird der VPort an die PF angefügt.

NumQueuePairs

Ein ULONG-Wert, der die Anzahl der für diesen VPort konfigurierten Warteschlangenpaare angibt.

Ein Warteschlangenpaar besteht aus einer Übertragungs- und einer Empfangswarteschlange. Warteschlangenpaare, die dem Standard-VPort zugeordnet sind, werden zum Zeitpunkt der Switcherstellung über eine OID-Methodenanforderung von OID_NIC_SWITCH_CREATE_SWITCH konfiguriert. Mindestens ein Warteschlangenpaar wird für einen nicht standardmäßigen VPort über eine OID-Methodenanforderung von OID_NIC_SWITCH_CREATE_VPORT konfiguriert.

InterruptModeration

Ein NDIS_NIC_SWITCH_VPORT_INTERRUPT_MODERATION Wert, der die Einstellung für die Unterbrechungsmoderation des VPorts angibt.

VPortState

Ein NDIS_NIC_SWITCH_VPORT_STATE Wert, der den Status des VPorts angibt.

ProcessorAffinity

Ein GROUP_AFFINITY Wert, der die Gruppennummer und eine Bitmap der CPUs angibt, denen dieser VPort zugeordnet werden kann.

Dieser Member ist nur für die an die PF angefügten VPorts gültig. Dieses Feld ist für nicht standardmäßige VPorts gültig, die an eine VF angefügt sind.

LookaheadSize

Dieses Element ist für die zukünftige Verwendung reserviert. Dieser Member muss auf 0 (null) festgelegt werden.

NumFilters

Ein ULONG-Wert, der die Anzahl der Empfangsfilter angibt, die auf dem Netzwerkadapter konfiguriert wurden.

Hinweis Ab NDIS 6.30 muss der Miniporttreiber einen Zähler für die aktuelle Anzahl von Empfangsfiltern verwalten, die auf dem Netzwerkadapter festgelegt sind. Der Treiber muss den Zähler jedes Mal erhöhen, wenn ein Empfangsfilter über eine OID-Set-Anforderung von OID_RECEIVE_FILTER_SET_FILTER festgelegt wird. Außerdem muss der Treiber den Zähler jedes Mal dekrementieren, wenn ein Empfangsfilter durch eine OID-Set-Anforderung von OID_RECEIVE_FILTER_CLEAR_FILTER gelöscht wird.

Hinweise

Eine NDIS_NIC_SWITCH_VPORT_INFO-Struktur enthält Informationen zu einer der folgenden Komponenten:

Ein nicht standardmäßiger VPort, der zuvor über eine OID-Methodenanforderung von OID_NIC_SWITCH_CREATE_VPORT erstellt wurde.
Der Standard-VPort, der an die PF angefügt ist. Der Standard-VPort ist immer vorhanden und kann nicht gelöscht werden.

Mindestens eine NDIS_NIC_SWITCH_VPORT_INFO-Struktur wird über die NDIS_NIC_SWITCH_VPORT_INFO_ARRAY-Struktur zurückgegeben.

Weitere Informationen zur SR-IOV-Schnittstelle finden Sie unter Übersicht über single root E/O Virtualization (SR-IOV).