Freigeben über


NDIS_NIC_SWITCH_CAPABILITIES Struktur (ntddndis.h)

Die NDIS_NIC_SWITCH_CAPABILITIES-Struktur gibt die Funktionen eines NIC-Switches auf dem Netzwerkadapter an.

Syntax

typedef struct _NDIS_NIC_SWITCH_CAPABILITIES {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              NdisReserved1;
  ULONG              NumTotalMacAddresses;
  ULONG              NumMacAddressesPerPort;
  ULONG              NumVlansPerPort;
  ULONG              NdisReserved2;
  ULONG              NdisReserved3;
  ULONG              NicSwitchCapabilities;
  ULONG              MaxNumSwitches;
  ULONG              MaxNumVPorts;
  ULONG              NdisReserved4;
  ULONG              MaxNumVFs;
  ULONG              MaxNumQueuePairs;
  ULONG              NdisReserved5;
  ULONG              NdisReserved6;
  ULONG              NdisReserved7;
  ULONG              MaxNumQueuePairsPerNonDefaultVPort;
  ULONG              NdisReserved8;
  ULONG              NdisReserved9;
  ULONG              NdisReserved10;
  ULONG              NdisReserved11;
  ULONG              NdisReserved12;
  ULONG              MaxNumMacAddresses;
  ULONG              NdisReserved13;
  ULONG              NdisReserved14;
  ULONG              NdisReserved15;
  ULONG              NdisReserved16;
  ULONG              NdisReserved17;
  ULONG              MaxNumRssCapableNonDefaultPFVPorts;
  ULONG              NumberOfIndirectionTableEntriesForDefaultVPort;
  ULONG              NumberOfIndirectionTableEntriesPerNonDefaultPFVPort;
  ULONG              MaxNumQueuePairsForDefaultVPort;
} NDIS_NIC_SWITCH_CAPABILITIES, *PNDIS_NIC_SWITCH_CAPABILITIES;

Angehörige

Header

Der Typ, die Überarbeitung und die Größe der NDIS_NIC_SWITCH_CAPABILITIES 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_CAPABILITIES-Struktur anzugeben, muss der Treiber das element RevisionHeader- auf einen der folgenden Werte festlegen:

NDIS_NIC_SWITCH_CAPABILITIES_REVISION_3

Die RSS-Schnittstellenmitglieder für NDIS 6.60 wurden hinzugefügt.

Hinweis Revision 3 dieser Struktur nur unter Windows Server 2016 und höheren Versionen von Windows Server unterstützt wird.

 

Legen Sie das Size Member auf NDIS_SIZEOF_NIC_SWITCH_CAPABILITIES_REVISION_3 fest.

NDIS_NIC_SWITCH_CAPABILITIES_REVISION_2

Die Einzelnen Stamm-I/O-Virtualisierungsmitglieder (SR-IOV) für NDIS 6.30 wurden hinzugefügt.

Hinweis Revision 2 dieser Struktur nur unter Windows Server 2012 und höheren Versionen von Windows Server unterstützt wird.

 

Legen Sie das Size Member auf NDIS_SIZEOF_NIC_SWITCH_CAPABILITIES_REVISION_2 fest.

NDIS_NIC_SWITCH_CAPABILITIES_REVISION_1

Originalversion für NDIS 6.20.

Legen Sie das Size Member auf NDIS_SIZEOF_NIC_SWITCH_CAPABILITIES_REVISION_1 fest.

Flags

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

NdisReserved1

Reserviert für NDIS.

NumTotalMacAddresses

Ein ULONG-Wert, der die Gesamtanzahl der vom Netzwerkadapter unterstützten Medienzugriffssteuerungsadressen (MEDIA Access Control, MAC) enthält.

Hinweis Treiber müssen dieses Element für Revision 2 und spätere Überarbeitungen dieser Struktur auf Null festlegen.
 

NumMacAddressesPerPort

Ein ULONG-Wert, der die Anzahl der MAC-Adressen enthält, die für jeden Port unterstützt werden.

Hinweis Treiber müssen dieses Element für Revision 2 und spätere Überarbeitungen dieser Struktur auf Null festlegen.
 

NumVlansPerPort

Ein ULONG-Wert, der die Anzahl der VLANs enthält, die für jeden Port unterstützt werden.

Hinweis Treiber müssen dieses Element für Revision 2 und spätere Überarbeitungen dieser Struktur auf Null festlegen.
 

NdisReserved2

Reserviert für NDIS.

NdisReserved3

Reserviert für NDIS.

NicSwitchCapabilities

Ein ULONG-Wert, der einen bitweisen OR der folgenden Flags enthält, die die Funktionen des NIC-Switches angeben:

NDIS_NIC_SWITCH_CAPS_RSS_ON_PF_VPORTS_SUPPORTED

Hinweis Dieses Kennzeichen wird in Windows Server 2016 und höher unterstützt. Es wurde in NDIS 6.60 eingeführt.

Gibt an, dass die NIC VMMQ für PF-VPorts unterstützt.

NDIS_NIC_SWITCH_CAPS_RSS_PER_PF_VPORT_INDIRECTION_TABLE_SUPPORTED

Hinweis Dieses Kennzeichen wird in Windows Server 2016 und höher unterstützt. Es wurde in NDIS 6.60 eingeführt.

Wenn dieser Wert auf 1festgelegt ist, gibt die NIC an, dass die NIC pro PF-VPort-Dereferenzierungstabellen verwalten kann.

NDIS_NIC_SWITCH_CAPS_RSS_PER_PF_VPORT_HASH_FUNCTION_SUPPORTED

Hinweis Dieses Kennzeichen wird in Windows Server 2016 und höher unterstützt. Es wurde in NDIS 6.60 eingeführt.

Wenn dieser Wert auf 1festgelegt ist, wird angegeben, dass die NIC das Festlegen einer anderen Hashfunktion pro PF-VPort unterstützt. Wenn dieses Kennzeichen festgelegt ist, muss auch NDIS_NIC_SWITCH_CAPS_RSS_PER_PF_VPORT_HASH_KEY_SUPPORTED festgelegt werden.

NDIS_NIC_SWITCH_CAPS_RSS_PER_PF_VPORT_HASH_TYPE_SUPPORTED

Hinweis Dieses Kennzeichen wird in Windows Server 2016 und höher unterstützt. Es wurde in NDIS 6.60 eingeführt.

Wenn dieser Wert auf 1festgelegt ist, gibt die NIC an, dass die NIC das Festlegen verschiedener Hashtypen pro PF-VPort unterstützt.

NDIS_NIC_SWITCH_CAPS_RSS_PER_PF_VPORT_HASH_KEY_SUPPORTED

Hinweis Dieses Kennzeichen wird in Windows Server 2016 und höher unterstützt. Es wurde in NDIS 6.60 eingeführt.

Wenn dieser Wert auf 1festgelegt ist, gibt die NIC an, dass die NIC das Festlegen eines anderen Hashschlüssels pro PF-VPort unterstützt. Dieses Kennzeichen muss festgelegt werden, wenn NDIS_NIC_SWITCH_CAPS_RSS_PER_PF_VPORT_HASH_FUNCTION_SUPPORTED festgelegt ist.

NDIS_NIC_SWITCH_CAPS_RSS_PER_PF_VPORT_INDIRECTION_TABLE_SIZE_RESTRICTED

Hinweis Dieses Kennzeichen wird in Windows Server 2016 und höher unterstützt. Es wurde in NDIS 6.60 eingeführt.

Wenn dieser Wert auf 1festgelegt ist, gibt die NIC eine Einschränkung der Tabellengröße für PF-VPorts an. Diese Kennzeichnung erzwingt den Aussteller eines RSS-OID, eine Tabellengröße pro PF VPort-Dereferenzierung zu verwenden, die der Anzahl der VPort-Warteschlangen entspricht, die auf die nächste Potenz von zwei aufgerundet wurden. Dies gilt nur für PF-VPorts und gilt nicht für VF VPorts. Dieses Flag kann mit dem NDIS_NIC_SWITCH_CAPS_ASYMMETRIC_QUEUE_PAIRS_FOR_NONDEFAULT_VPORT_SUPPORTED-Flag kombiniert werden (unterschiedliche PF-VPorts können unterschiedliche Anzahl von Warteschlangen haben). Mit dieser Kennzeichnung wird verhindert, dass VMMQ-Benutzer eine feinkörnige Warteschlangensteuerung durchführen.

NDIS_NIC_SWITCH_CAPS_NIC_SWITCH_WITHOUT_IOV_SUPPORTED

Hinweis Dieses Kennzeichen wird in Windows Server 2016 und höher unterstützt.

Dieses flag, eingeführt mit NDIS 6.60, gibt an, dass ein NIC-Switch ohne die Verwendung von SR-IOV erstellt werden kann. Diese Kennzeichnung ermöglicht das Trennen eines NIC-Switches vom Schlüsselwort *SRIOV, was bedeutet, dass ein NIC-Switch über OID_NIC_SWITCH_CREATE_SWITCH erstellt werden kann, auch wenn *SRIOV = 0.

Weitere Informationen zum Melden von NIC-Switchfunktionen für NDIS 6.60 und höhere Miniporttreiber finden Sie unter Ermitteln von NIC-Switch-Funktionen.

NDIS_NIC_SWITCH_CAPS_VLAN_SUPPORTED

Dieses Flag gibt an, dass der NIC-Switch die Hardwarepaketfilterung basierend auf dem VLAN-Bezeichner (Virtual Local Area Network) (ID) unterstützt.

Hinweis Dieses Flag sollte nur festgelegt werden, wenn der NIC-Switch die VLAN-ID-Filterung für einzelne SR-IOV virtuellen Ports (VPorts) unterstützt.
 

NDIS_NIC_SWITCH_CAPS_PER_VPORT_INTERRUPT_MODERATION_SUPPORTED

Dieses Flag gibt an, dass der NIC-Switch die Unterbrechungsmoderationskonfiguration für einzelne VPorts unterstützen kann.

NDIS_NIC_SWITCH_CAPS_ASYMMETRIC_QUEUE_PAIRS_FOR_NONDEFAULT_VPORT_SUPPORTED

Dieses Flag gibt an, dass der NIC-Switch eine andere Anzahl von Warteschlangenpaaren für jeden nicht standardmäßigen VPort konfigurieren kann. Dies bedeutet, dass jeder nicht standardmäßige VPort asymmetrisch konfiguriert werden kann, um eine andere Anzahl von Warteschlangenpaaren zu haben.

Wenn dieses Flag nicht festgelegt ist, müssen alle nicht standardmäßigen VPorts symmetrisch konfiguriert werden, damit die gleiche Anzahl von Warteschlangenpaaren vorhanden ist.

Unabhängig davon, ob dieses Flag festgelegt ist, muss der NIC-Switch die Möglichkeit unterstützen, die Anzahl der Warteschlangenpaare für den Standard-VPort festzulegen. Diese können sich von der Anzahl der Warteschlangenpaare unterscheiden, die für die nicht standardmäßigen VPorts festgelegt sind.

Hinweis 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.
 
Weitere Informationen finden Sie unter Symmetrische und asymmetrische Zuordnung von Warteschlangenpaaren.

NDIS_NIC_SWITCH_CAPS_VF_RSS_SUPPORTED

Dieses Flag gibt an, dass Warteschlangenpaare von nicht standardmäßigen VPorts, die an eine virtuelle PCI Express -Funktion (PCIe) (PCIe) angefügt sind, für die empfangsseitige Skalierung (RSS) verwendet werden können. Der VF Miniport-Treiber wird im Gastbetriebssystem einer Hyper-V untergeordneten Partition ausgeführt.

Wenn dieses Flag festgelegt ist, unterstützt der Miniporttreiber RSS auf einem VF und kann ein oder mehrere Warteschlangenpaare aus dem nicht standardmäßigen VPort für RSS verwenden.

Hinweis Ab Windows Server 2012 kann nur ein nicht standardmäßiger VPort an einen VF angefügt werden.
 

NDIS_NIC_SWITCH_CAPS_SINGLE_VPORT_POOL

Dieses Flag gibt an, dass die nicht standardmäßigen VPorts auf nicht reservierte Weise aus dem VPort-Pool auf dem Netzwerkadapter erstellt werden können. Auf diese Weise können verfügbare nicht standardmäßige VPorts erstellt und nach Bedarf dem PF zugewiesen und zugewiesen werden. Wenn der Netzwerkadapter die VMQ-Schnittstelle (Virtual Machine Queue) unterstützt, können nicht standardmäßige VPorts, die der PF zugewiesen sind, auch für VM-Empfangswarteschlangen verwendet werden.

Hinweis Der Standard-VPort ist immer für die Zuordnung zur PF reserviert.
 
Wenn dieses Flag festgelegt ist, werden verfügbare nicht standardmäßige VPorts erstellt und der PF zugewiesen und zugewiesene VFs zugewiesen. Dieser Mechanismus reserviert jedoch keine nicht standardmäßigen VPorts für die Erstellung und Zuordnung von VF. Daher können Situationen auftreten, in denen einem VF möglicherweise kein VPort zugewiesen wird, wenn der Pool von verfügbaren VPorts erschöpft wurde.
Hinweis Wenn einem VF kein VPort zugewiesen werden kann, erfolgt der Paketdatenverkehr über den VF über den SR-IOV synthetischen Datenpfad. Weitere Informationen zu diesem Datenpfad finden Sie unter SR-IOV Datenpfade.
 
Wenn dieses Flag nicht festgelegt ist, ist die Erstellung und Zuweisung von nicht standardmäßigen VPorts für die VF-Zuordnung reserviert. Zusätzliche nicht standardmäßige VPorts können erstellt und der PF zugewiesen werden.

Weitere Informationen zu VMQ finden Sie unter VMQ(Virtual Machine Queue).

Weitere Informationen zu VPorts finden Sie unter Managing Virtual Ports.

MaxNumSwitches

Ein ULONG-Wert, der die maximale Anzahl von Switches angibt, die auf der PCI Express -Funktion (PCIe) des Netzwerkadapters (PCIe) Physical Function (PF) erstellt werden können.

Hinweis Ab Windows Server 2012 unterstützt Windows nur den Standard-NIC-Switch auf dem Netzwerkadapter. Daher muss dieses Element immer auf ein Element festgelegt werden.
 

MaxNumVPorts

Ein ULONG-Wert, der die maximale Anzahl von VPorts angibt, die auf einem Netzwerkadapter erstellt werden können. Dies schließt den standardmäßigen VPort ein, der immer an die PF angefügt ist.

Hinweis Der NIC-Switch muss mindestens (MaxNumVFs + 1) VPorts unterstützen.
 

NdisReserved4

Reserviert für NDIS.

MaxNumVFs

Ein ULONG-Wert, der die maximale Anzahl von VFs angibt, die auf dem NIC-Switch erstellt werden können.

Hinweis Je nach den verfügbaren Hardwareressourcen auf dem Netzwerkadapter kann der Miniporttreiber den MaxNumVFs Member auf einen Wert festlegen, der kleiner als sein *NumVFs Schlüsselwort ist. Weitere Informationen zu diesem Schlüsselwort finden Sie unter Standardisierte INF-Schlüsselwörter für SR-IOV-.
 

MaxNumQueuePairs

Ein ULONG-Wert, der die maximale Anzahl von Warteschlangenpaaren angibt, die allen VPorts zugewiesen werden können. Dies schließt den standard-VPort ein, der an die PF angefügt ist.

Hinweis Dieser Wert muss größer oder gleich dem Wert von MaxNumVPortssein.
 

NdisReserved5

Reserviert für NDIS.

NdisReserved6

Reserviert für NDIS.

NdisReserved7

Reserviert für NDIS.

MaxNumQueuePairsPerNonDefaultVPort

Ein ULONG-Wert, der die maximale Anzahl von Warteschlangenpaaren angibt, die einem nicht standardmäßigen VPort zugewiesen werden können.

Dieser Wert wird in den Kräften von 2 angegeben und stellt eine asymmetrische Konfiguration und Zuordnung von Warteschlangenpaaren zu VPorts bereit. Weitere Informationen finden Sie unter Symmetrische und asymmetrische Zuordnung von Warteschlangenpaaren.

NdisReserved8

Reserviert für NDIS.

NdisReserved9

Reserviert für NDIS.

NdisReserved10

Reserviert für NDIS.

NdisReserved11

Reserviert für NDIS.

NdisReserved12

Reserviert für NDIS.

MaxNumMacAddresses

Ein ULONG-Wert, der die maximale Anzahl von Unicast MAC-Adressfiltern angibt, die auf dem NIC-Switch verfügbar sind.

Hinweis Dieser Wert muss größer oder gleich dem Wert von MaxNumVPortssein. Dadurch kann jeder VPort (einschließlich des Standard-VPort) so konfiguriert werden, dass mindestens ein Unicast MAC-Adressfilter vorhanden ist.
 

NdisReserved13

Reserviert für NDIS.

NdisReserved14

Reserviert für NDIS.

NdisReserved15

Reserviert für NDIS.

NdisReserved16

Reserviert für NDIS.

NdisReserved17

Reserviert für NDIS.

MaxNumRssCapableNonDefaultPFVPorts

Ein ULONG-Wert, der die maximale Anzahl von RSS-fähigen nicht standardmäßigen PFVPorts angibt.

NumberOfIndirectionTableEntriesForDefaultVPort

Ein ULONG-Wert, der die Anzahl der Dereferenzierungstabelleneinträge für den Standard-VPort angibt.

NumberOfIndirectionTableEntriesPerNonDefaultPFVPort

Ein ULONG-Wert, der die Anzahl der Dereferenzierungstabelleneinträge für jeden nicht standardmäßigen PFVPort angibt.

MaxNumQueuePairsForDefaultVPort

Ein ULONG-Wert, der die maximale Anzahl von Warteschlangenpaaren angibt, die dem Standard-VPort zugewiesen werden können.

Dieser Wert wird in den Kräften von 2 angegeben und stellt eine asymmetrische Konfiguration und Zuordnung von Warteschlangenpaaren zu VPorts bereit. Weitere Informationen finden Sie unter Symmetrische und asymmetrische Zuordnung von Warteschlangenpaaren.

Bemerkungen

Die NDIS_NIC_SWITCH_CAPABILITIES Struktur wird in den Elementen der folgenden Strukturen verwendet:

OID-Abfrageanforderungen von OID_NIC_SWITCH_CURRENT_CAPABILITIES und OID_NIC_SWITCH_HARDWARE_CAPABILITIES eine NDIS_NIC_SWITCH_CAPABILITIES Struktur zurückgeben.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Unterstützt in NDIS 6.20 und höher.
Header- ntddndis.h (include Ndis.h)

Siehe auch

NDIS_BIND_PARAMETERS

NDIS_FILTER_ATTACH_PARAMETERS

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_CREATE_VPORT

OID_NIC_SWITCH_CURRENT_CAPABILITIES

OID_NIC_SWITCH_HARDWARE_CAPABILITIES