NDIS_NIC_SWITCH_PARAMETERS-Struktur (ntddndis.h)

Artikel
02/26/2024

Die NDIS_NIC_SWITCH_PARAMETERS-Struktur gibt die Konfigurationsparameter eines Netzwerkadapterswitches auf dem Netzwerkadapter an.

Syntax

typedef struct _NDIS_NIC_SWITCH_PARAMETERS {
  NDIS_OBJECT_HEADER           Header;
  ULONG                        Flags;
  NDIS_NIC_SWITCH_TYPE         SwitchType;
  NDIS_NIC_SWITCH_ID           SwitchId;
  NDIS_NIC_SWITCH_FRIENDLYNAME SwitchFriendlyName;
  ULONG                        NumVFs;
  ULONG                        NdisReserved1;
  ULONG                        NdisReserved2;
  ULONG                        NdisReserved3;
  ULONG                        NumQueuePairsForDefaultVPort;
} NDIS_NIC_SWITCH_PARAMETERS, *PNDIS_NIC_SWITCH_PARAMETERS;

Member

Header

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

NDIS_NIC_SWITCH_PARAMETERS_REVISION_1

Originalversion für NDIS 6.30 und höher.

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

Flags

Ein ULONG-Wert, der ein bitweises OR von Flags enthält. Die folgenden Flags sind für diesen Member definiert.

NDIS_NIC_SWITCH_PARAMETERS_SWITCH_NAME_CHANGED

Dieses Flag gibt an, dass das Feld, das in der NDIS_NIC_SWITCH_PARAMETERS-Struktur aktualisiert wurde, das SwitchName-Element ist.

Hinweis Dieses Flag ist nur gültig, wenn diese Struktur in einer OID-Satzanforderung von OID_NIC_SWITCH_PARAMETERS verwendet wird.

SwitchType

Ein NDIS_NIC_SWITCH_TYPE Enumerationswert, der den Typ des Netzwerkadapterswitches angibt.

Hinweis Ab Windows Server 2012 unterstützt Windows nur den Switchtyp NdisNicSwitchTypeExternal. Ein externer Switch gibt an, dass die ports, die mit diesem Switchtyp verbunden sind, über den physischen Port des Netzwerkadapters auf das externe Netzwerk zugreifen können. Der standardmäßige virtuelle Port (VPort) auf dem externen Switch bietet externe Netzwerkkonnektivität mit dem Virtualisierungsstapel, der im Verwaltungsbetriebssystem der übergeordneten Hyper-V-Partition ausgeführt wird.

SwitchId

Ein NDIS_NIC_SWITCH_ID Wert, der einen Switchbezeichner enthält. 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 eine Beschreibung für den Switch enthält.

NumVFs

Ein ULONG-Wert, der die Anzahl der auf dem Netzwerkadapter aktivierten VIRTUELLEN FUNKTIONEN (PCI Express, PCIe) angibt. VFs werden auf dem Adapter aktiviert, wenn die Virtualisierung über einen Aufruf von NdisMEnableVirtualization aktiviert wird.

Hinweis Bevor ein VF an eine untergeordnete Hyper-V-Partition angefügt werden kann, müssen ressourcen über eine OID-Methodenanforderung von OID_NIC_SWITCH_ALLOCATE_VF zugeordnet werden.

NdisReserved1

Reserviert für NDIS.

NdisReserved2

Reserviert für NDIS.

NdisReserved3

Reserviert für NDIS.

NumQueuePairsForDefaultVPort

Hinweise

Die NDIS_NIC_SWITCH_PARAMETERS-Struktur wird in OID-Methodenanforderungen von OID_NIC_SWITCH_CREATE_SWITCH und OID_NIC_SWITCH_PARAMETERS verwendet. Diese OID-Anforderungen legen die Konfigurationsparameter eines Netzwerkadapterswitches fest oder fragen sie ab.

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