NDIS_NIC_SWITCH_PARAMETERS Struktur (ntddndis.h)

Artikel
02/07/2025

Die NDIS_NIC_SWITCH_PARAMETERS-Struktur gibt die Konfigurationsparameter eines Netzwerkadapterschalters 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;

Angehörige

Header

Der Typ, die Überarbeitung und die Größe der NDIS_NIC_SWITCH_PARAMETERS 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_PARAMETERS-Struktur anzugeben, muss der Treiber das element RevisionHeader- 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 werden für dieses Element 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 Kennzeichen ist nur gültig, wenn diese Struktur in einer OID-Satzanforderung von OID_NIC_SWITCH_PARAMETERSverwendet wird.

SwitchType

Ein NDIS_NIC_SWITCH_TYPE Enumerationswert, der den Typ des Netzwerkadapterswitches angibt.

Hinweis Ab Windows Server 2012 unterstützt Windows nur einen Switchtyp NdisNicSwitchTypeExternal. Ein externer Switch gibt an, dass die mit diesem Switchtyp verbundenen Ports über den physischen Port des Netzwerkadapters auf das externe Netzwerk zugreifen können. Der virtuelle Standardport (VPort) auf dem externen Switch stellt eine externe Netzwerkkonnektivität mit dem Virtualisierungsstapel bereit, 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 der Switches, die der Netzwerkadapter unterstützt. Ein NDIS_DEFAULT_SWITCH_ID Wert gibt den Standard-Netzwerkadapter-Switch 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.

SwitchFriendlyName

Ein NDIS_NIC_SWITCH_FRIENDLYNAME Wert, der eine Beschreibung für den Schalter enthält.

NumVFs

Ein ULONG-Wert, der die Anzahl der virtuellen PCI-Express-Funktionen (PCIe) angibt, die auf dem Netzwerkadapter aktiviert sind. VFs werden auf dem Adapter aktiviert, wenn die Virtualisierung über einen Aufruf von NdisMEnableVirtualizationaktiviert wird.

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

NdisReserved1

Reserviert für NDIS.

NdisReserved2

Reserviert für NDIS.

NdisReserved3

Reserviert für NDIS.

NumQueuePairsForDefaultVPort

Bemerkungen

Die NDIS_NIC_SWITCH_PARAMETERS Struktur wird in OID-Methodenanforderungen von OID_NIC_SWITCH_CREATE_SWITCH und OID_NIC_SWITCH_PARAMETERSverwendet. Diese OID-Anforderungen legen die Konfigurationsparameter eines Netzwerkadapterswitchs fest oder abfragen sie.

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