NDIS_NIC_SWITCH_VPORT_INFO Struktur (ntddndis.h)

Artikel
02/07/2025

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;

Angehörige

Header

Der Typ, die Überarbeitung und die Größe der NDIS_NIC_SWITCH_VPORT_INFO Struktur. Dieses Element ist als NDIS_OBJECT_HEADER Struktur formatiert.

Der Miniporttreiber muss den Type Member von Header- auf NDIS_OBJECT_TYPE_DEFAULT festlegen. Um die Version der NDIS_NIC_SWITCH_VPORT_INFO-Struktur anzugeben, muss der Treiber den Revision Member 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 Size Member 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.

Ein Wert von NDIS_DEFAULT_VPORT_ID gibt den Standard-VPort auf dem Switch an. Der Standard-VPort ist immer an die PHYSISCHE Funktion PCI Express (PCIe) des Netzwerkadapters angeschlossen.

Hinweis A nondefault VPort with the specified VPortId value must have been created through an OID method request of OID_NIC_SWITCH_CREATE_VPORT.

Flags

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

SwitchId

Ein NDIS_NIC_SWITCH_ID Wert, der einen Netzwerkadapterswitch identifiziert, der auf dem Netzwerkadapter erstellt wurde. Der über das VPortId- Mitglied identifizierte VPort wird auf dem durch das SwitchId Member angegebenen Switch Erstellt.

Der Switchbezeichner ist eine ganze Zahl zwischen Null und der Anzahl der Switches, die der Netzwerkadapter unterstützt. Ein Wert von NDIS_DEFAULT_SWITCH_ID gibt den Standardmäßigen Netzwerkadapterswitch an.

Hinweis Ab Windows Server 2012 unterstützt die einzelne I/O-Virtualisierungsschnittstelle (SR-IOV) nur den Standard-Netzwerkadapterschalter auf dem Netzwerkadapter. Der Wert dieses Elements muss auf NDIS_DEFAULT_SWITCH_ID festgelegt werden.

VPortName

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

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 Warteschlangenpaare angibt, die für diesen VPort konfiguriert sind.

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

InterruptModeration

Ein NDIS_NIC_SWITCH_VPORT_INTERRUPT_MODERATION Wert, der die Unterbrechungsmoderationseinstellung des VPort angibt.

VPortState

Ein NDIS_NIC_SWITCH_VPORT_STATE Wert, der den Status des VPort angibt.

ProcessorAffinity

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

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

LookaheadSize

Dieses Mitglied ist für die zukünftige Verwendung reserviert. Dieses Element muss auf Null festgelegt werden.

NumFilters

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

Hinweis Ab NDIS 6.30 muss der Miniporttreiber einen Zähler für die aktuelle Anzahl von Empfangenfiltern beibehalten, die auf dem Netzwerkadapter festgelegt sind. Der Treiber muss den Zähler jedes Mal erhöhen, wenn ein Empfangsfilter über eine OID-Setanforderung von OID_RECEIVE_FILTER_SET_FILTERfestgelegt wird. Der Treiber muss den Zähler auch jedes Mal erhöhen, wenn ein Empfangsfilter durch eine OID-Setanforderung von OID_RECEIVE_FILTER_CLEAR_FILTERgelöscht wird.

Bemerkungen

Eine NDIS_NIC_SWITCH_VPORT_INFO Struktur enthält Informationen zu einem der folgenden Elemente:

Ein nicht standardmäßiger VPort, der zuvor über eine OID-Methodenanforderung von OID_NIC_SWITCH_CREATE_VPORTerstellt 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 Strukturen werden durch die NDIS_NIC_SWITCH_VPORT_INFO_ARRAY-Struktur zurückgegeben.

Weitere Informationen zur SR-IOV-Schnittstelle finden Sie unter Übersicht über die Single Root I/O Virtualization (SR-IOV).