NDIS_NIC_SWITCH_VPORT_INFO_ARRAY-Struktur (ntddndis.h)

Artikel
03/01/2024

Die NDIS_NIC_SWITCH_VPORT_INFO_ARRAY-Struktur gibt ein Array an. Jedes Element im Array gibt die Attribute eines virtuellen Ports (VPort) an, der auf dem Netzwerkadapterswitch eines Netzwerkadapters erstellt wurde.

Syntax

typedef struct _NDIS_NIC_SWITCH_VPORT_INFO_ARRAY {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  Flags;
  NDIS_NIC_SWITCH_ID     SwitchId;
  NDIS_SRIOV_FUNCTION_ID AttachedFunctionId;
  ULONG                  FirstElementOffset;
  ULONG                  NumElements;
  ULONG                  ElementSize;
} NDIS_NIC_SWITCH_VPORT_INFO_ARRAY, *PNDIS_NIC_SWITCH_VPORT_INFO_ARRAY;

Member

Header

Typ, Revision und Größe der NDIS_NIC_SWITCH_VPORT_INFO_ARRAY-Struktur . Dieser Member ist als NDIS_OBJECT_HEADER-Struktur formatiert.

NDIS legt den Type-Member von Header auf NDIS_OBJECT_TYPE_DEFAULT fest. Um die Version der NDIS_NIC_SWITCH_VPORT_INFO_ARRAY-Struktur anzugeben, legt NDIS den Revisionsmember von Header auf den folgenden Wert fest:

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_REVISION_1

Originalversion für NDIS 6.30 und höher.

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

Flags

Ein ULONG-Wert, der ein bitweises OR der folgenden Flags enthält:

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_FUNCTION

Dieses Flag gibt an, die VPorts aufzulisten, die an eine bestimmte PCI Express-Funktion (PCIe) angefügt sind. Die Funktion wird im AttachedFunctionId-Element angegeben. Dieses Flag kann verwendet werden, um die VPorts aufzulisten, die an die physische PCIe-Funktion (PF) oder eine angegebene virtuelle PCIe-Funktion (VF) angefügt sind.

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH

Dieses Flag gibt an, die VPorts aufzulisten, die auf einem bestimmten Switch erstellt wurden, der durch die SwitchId angegeben wird. Dadurch werden alle auf dem Switch erstellten VPorts aufgelistet.

Hinweis Diese Flags schließen sich gegenseitig aus. Im Flags-Element kann nur ein Flag festgelegt werden.

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.

Der SwitchId-Member ist nur gültig, wenn NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH im Flags-Element angegeben ist.

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.

AttachedFunctionId

Ein NDIS_SRIOV_FUNCTION_ID Wert, der den Bezeichner der PF oder eine VF auf dem Netzwerkadapter angibt.

Hinweis Wenn dieser Wert NDIS_PF_FUNCTION_ID ist, wird der VPort an die PF angefügt.

Das AttachedFunctionId-Element ist nur gültig, wenn NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_FUNCTION im Flags-Member angegeben ist.

FirstElementOffset

Ein ULONG-Wert, der den Offset in Bytes für das erste Element in einem Array von Elementen angibt, die dieser Struktur folgen. Der Offset wird vom Anfang der NDIS_NIC_SWITCH_VPORT_INFO_ARRAY-Struktur bis zum Anfang des ersten Elements gemessen. Jedes Element im Array ist eine NDIS_NIC_SWITCH_VPORT_INFO-Struktur .

Hinweis Wenn NumElements auf 0 festgelegt ist, wird dieser Member ignoriert.

NumElements

Ein ULONG-Wert, der die Anzahl der Elemente angibt, die der NDIS_NIC_SWITCH_VPORT_INFO_ARRAY-Struktur folgen.

ElementSize

Ein ULONG-Wert, der die Größe jedes Elements in Byte angibt, das der NDIS_NIC_SWITCH_VPORT_INFO_ARRAY-Struktur folgt.

Hinweise

NDIS gibt eine NDIS_NIC_SWITCH_VPORT_INFO_ARRAY-Struktur zurück, wenn NDIS eine OID-Methodenanforderung von OID_NIC_SWITCH_ENUM_VPORTS verarbeitet. Jedes Element im Array, das der NDIS_NIC_SWITCH_VPORT_INFO_ARRAY-Struktur folgt, ist ein
NDIS_NIC_SWITCH_VPORT_INFO Struktur.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.30 und höher.
Kopfzeile	ntddndis.h (include Ndis.h)

Weitere Informationen

NDIS_NIC_SWITCH_VPORT_INFO

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_ENUM_VPORTS

Freigeben über