NDIS_NIC_SWITCH_VPORT_INFO_ARRAY Struktur (ntddndis.h)

Artikel
02/07/2025

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

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;

Angehörige

Header

Der Typ, die Überarbeitung und die Größe der NDIS_NIC_SWITCH_VPORT_INFO_ARRAY Struktur. Dieses Element ist als NDIS_OBJECT_HEADER Struktur formatiert.

NDIS legt den Type Member Header- auf NDIS_OBJECT_TYPE_DEFAULT fest. Um die Version der NDIS_NIC_SWITCH_VPORT_INFO_ARRAY Struktur anzugeben, legt NDIS den Revision Member 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 den Size Member auf NDIS_SIZEOF_NIC_SWITCH_VPORT_INFO_ARRAY_REVISION_1 fest.

Flags

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

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_FUNCTION

Dieses Kennzeichen gibt an, dass die an eine bestimmte PCI Express (PCIe)-Funktion angeschlossenen VPorts aufgezählt werden. Die Funktion wird im AttachedFunctionId Member angegeben. Dieses Flag kann verwendet werden, um die an die PCIe Physical Function (PF) oder eine angegebene PCIe Virtual Function (VF) angefügten VPorts aufzählen zu können.

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH

Dieses Flag gibt an, dass die auf einem bestimmten Switch erstellten VPorts aufgelistet werden, die von der SwitchId angegeben werden. Dadurch werden alle auf dem Switch erstellten VPorts aufgelistet.

Hinweis Diese Flags schließen sich gegenseitig aus. Nur ein Kennzeichen kann im Flags Mitglied festgelegt werden.

SwitchId

Ein NDIS_NIC_SWITCH_ID Wert, der einen Switchbezeichner angibt. 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.

Das SwitchId Member ist nur gültig, wenn NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH im Flags Mitglied angegeben ist.

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.

AttachedFunctionId

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

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

Der AttachedFunctionId- Member 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 Byte angibt, auf das erste Element in einem Array von Elementen, 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.

Note If NumElements is set to zero, this member is ignored.

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.

Bemerkungen

NDIS gibt eine NDIS_NIC_SWITCH_VPORT_INFO_ARRAY Struktur zurück, wenn NDIS eine OID-Methodenanforderung von OID_NIC_SWITCH_ENUM_VPORTSverarbeitet. Jedes Element im Array, das auf die NDIS_NIC_SWITCH_VPORT_INFO_ARRAY Struktur folgt, ist eine
NDIS_NIC_SWITCH_VPORT_INFO Struktur.

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

Anforderungen

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

Siehe auch

NDIS_NIC_SWITCH_VPORT_INFO

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_ENUM_VPORTS

Freigeben über