NDIS_NIC_SWITCH_INFO-Struktur (ntddndis.h)

Artikel
12/21/2023

Die NDIS_NIC_SWITCH_INFO-Struktur gibt die Informationen zu einem Netzwerkadapterswitch auf einem Netzwerkadapter an.

Syntax

typedef struct _NDIS_NIC_SWITCH_INFO {
  NDIS_OBJECT_HEADER           Header;
  ULONG                        Flags;
  NDIS_NIC_SWITCH_TYPE         SwitchType;
  NDIS_NIC_SWITCH_ID           SwitchId;
  NDIS_NIC_SWITCH_FRIENDLYNAME SwitchFriendlyName;
  ULONG                        NumVFs;
  ULONG                        NumAllocatedVFs;
  ULONG                        NumVPorts;
  ULONG                        NumActiveVPorts;
  ULONG                        NumQueuePairsForDefaultVPort;
  ULONG                        NumQueuePairsForNonDefaultVPorts;
  ULONG                        NumActiveDefaultVPortMacAddresses;
  ULONG                        NumActiveNonDefaultVPortMacAddresses;
  ULONG                        NumActiveDefaultVPortVlanIds;
  ULONG                        NumActiveNonDefaultVPortVlanIds;
} NDIS_NIC_SWITCH_INFO, *PNDIS_NIC_SWITCH_INFO;

Member

Header

Typ, Revision und Größe der NDIS_NIC_SWITCH_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_INFO-Struktur anzugeben, muss der Treiber den Revisionsmember von Header auf den folgenden Wert festlegen:

NDIS_NIC_SWITCH_INFO_REVISION_1

Originalversion für NDIS 6.30.

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

Flags

Ein ULONG-Wert, der ein bitweises OR mit Konfigurationsflags enthält, die auf dem Switch aktiviert sind.

Hinweis Für NDIS 6.30 sind keine Konfigurationsflags für den Switch definiert. Das Flags-Element muss auf 0 (null) festgelegt werden.

SwitchType

Ein NDIS_NIC_SWITCH_TYPE Wert, der den Typ des Schalters angibt.

SwitchId

Ein NDIS_NIC_SWITCH_ID Wert, der einen Switchbezeichner angibt. Der Switchbezeichner ist eine ganze Zahl zwischen null und der Anzahl von Switches, die vom Netzwerkadapter unterstützt werden. Ein NDIS_DEFAULT_SWITCH_ID-Wert 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.

SwitchFriendlyName

Ein NDIS_NIC_SWITCH_FRIENDLYNAME Wert, der die benutzerfreundliche Beschreibung des Schalters enthält.

NumVFs

Ein ULONG-Wert, der die Anzahl der auf dem Netzwerkadapter aktivierten VIRTUELLEN FUNKTIONEN (PCI Express, PCIe) angibt. Aktivierte VFs können sich entweder in einem zugeordneten oder nicht zugeordneten Zustand befinden.

NumAllocatedVFs

Ein ULONG-Wert, der die Anzahl der VFs angibt, die dem von SwitchId angegebenen Netzwerkadapterswitch zugeordnet wurden. VFs werden über OID-Mengenanforderungen von OID_NIC_SWITCH_ALLOCATE_VF zugeordnet.

NumVPorts

Ein ULONG-Wert, der die Anzahl der virtuellen Ports (VPorts) angibt, die für den von SwitchId angegebenen Netzwerkadapterswitch konfiguriert sind.

Dieser ULONG-Wert ist die Summe der folgenden Werte:

Die maximale Anzahl von VPorts, die über OID-Set-Anforderungen von OID_NIC_SWITCH_CREATE_VPORT erstellt werden können.
Der an die physische Funktion (PF) angefügte Standard-VPort.

NumActiveVPorts

Ein ULONG-Wert, der die Anzahl der VPorts angibt, die auf dem von SwitchId angegebenen Netzwerkadapterswitch erstellt wurden.

Hinweis Dieser ULONG-Wert enthält zusätzlich zu den nicht standardmäßigen VPorts, die über OID-Mengenanforderungen von OID_NIC_SWITCH_CREATE_VPORT erstellt wurden, den Standard-VPort.

NumQueuePairsForDefaultVPort

Ein ULONG-Wert, der die Anzahl der Warteschlangenpaare angibt, die dem Standard-VPort zugeordnet sind. Der Standard-VPort ist immer an die PF angefügt.

Ein Warteschlangenpaar besteht aus einer Übertragungs- und einer Empfangswarteschlange. Der Miniporttreiber verknüpft ein oder mehrere Warteschlangenpaare mit dem Standard-VPort zum Zeitpunkt der Switcherstellung über eine OID-Methodenanforderung von OID_NIC_SWITCH_CREATE_SWITCH.

Hinweis Ab NDIS 6.30 kann nur ein Warteschlangenpaar für den Standard-VPort konfiguriert werden.

NumQueuePairsForNonDefaultVPorts

Ein ULONG-Wert, der die Anzahl der Warteschlangenpaare angibt, die den nicht standardmäßigen VPorts zugeordnet sind. Ein nicht standardmäßiger VPort kann entweder an die PF oder einen beliebigen VF des Netzwerkadapters angefügt werden.

Der Miniporttreiber ordnet ein oder mehrere Warteschlangenpaare einem nicht standardmäßigen VPort über eine OID-Methodenanforderung von OID_NIC_SWITCH_CREATE_VPORT zu.

NumActiveDefaultVPortMacAddresses

Ein ULONG-Wert, der die Anzahl der Unicast-MAC-Adressfilter angibt, die derzeit für den Standard-VPort festgelegt sind, der an die PF des Netzwerkadapters angefügt ist.

NumActiveNonDefaultVPortMacAddresses

Ein ULONG-Wert, der die Anzahl der Unicast-MAC-Adressfilter angibt, die derzeit für nicht standardmäßige VPorts festgelegt sind.

NumActiveDefaultVPortVlanIds

Ein ULONG-Wert, der die Anzahl von VLAN-Bezeichnerfiltern (Virtual Local Area Network) angibt, die derzeit für den Standard-VPort festgelegt sind.

NumActiveNonDefaultVPortVlanIds

Ein ULONG-Wert, der die Anzahl der VLAN-Bezeichnerfilter angibt, die derzeit für die nicht standardmäßigen VPorts festgelegt sind.

Hinweise

Die NDIS_NIC_SWITCH_INFO-Struktur wird in OID-Abfrageanforderungen von OID_NIC_SWITCH_ENUM_SWITCHES verwendet. Diese OID-Anforderung wird verwendet, um die Netzwerkadapterswitches auf einem Netzwerkadapter aufzulisten. Wenn diese OID-Anforderung ausgegeben wird, werden mindestens eine NDIS_NIC_SWITCH_INFO-Strukturen innerhalb einer NDIS_NIC_SWITCH_INFO_ARRAY-Struktur zurückgegeben.

Hinweis Ab NDIS 6.30 wird nur die NDIS_NIC_SWITCH_INFO , die die Informationen zum Standardnetzwerkadapterswitch beschreibt, über eine OID-Anforderung von OID_NIC_SWITCH_ENUM_SWITCHES zurückgegeben.

Eine NDIS_NIC_SWITCH_INFO-Struktur enthält Informationen zu einem Netzwerkadapterswitch, der zuvor über eine OID-Methodenanforderung von OID_NIC_SWITCH_CREATE_SWITCH erstellt wurde.

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