NDIS_NIC_SWITCH_VF_INFO_ARRAY-Struktur (ntddndis.h)

Artikel
02/29/2024

Die NDIS_NIC_SWITCH_VF_INFO_ARRAY-Struktur gibt ein Array an. Jedes Element im Array gibt die Attribute einer PCI Express (PCIe) Virtual Functions (VF) an, die aktiviert und auf einem Netzwerkadapter zugeordnet wurden.

Syntax

typedef struct _NDIS_NIC_SWITCH_VF_INFO_ARRAY {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  NDIS_NIC_SWITCH_ID SwitchId;
  ULONG              FirstElementOffset;
  ULONG              NumElements;
  ULONG              ElementSize;
} NDIS_NIC_SWITCH_VF_INFO_ARRAY, *PNDIS_NIC_SWITCH_VF_INFO_ARRAY;

Member

Header

Typ, Revision und Größe der NDIS_NIC_SWITCH_VF_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_VF_INFO_ARRAY-Struktur anzugeben, legt NDIS den Revisionsmember von Header auf den folgenden Wert fest:

NDIS_NIC_SWITCH_VF_INFO_ARRAY_REVISION_1

Originalversion für NDIS 6.30 und höher.

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

Flags

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

NDIS_NIC_SWITCH_VF_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH

Wenn dieses Flag festgelegt ist, darf der Miniporttreiber nur ein Array von NDIS_NIC_SWITCH_VF_INFO Strukturen für VFs zurückgeben, die dem vom SwitchId-Member angegebenen Netzwerkadapterswitch zugeordnet wurden. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

Wenn das Flags-Element auf 0 festgelegt ist, muss der Miniporttreiber ein Array von NDIS_NIC_SWITCH_VF_INFO Strukturen für jede VF zurückgeben, die auf jedem Netzwerkadapterswitch des Netzwerkadapters zugeordnet wurde.

Hinweis Ab Windows Server 2012 unterstützt die SR-IOV-Schnittstelle nur den Standard-Netzwerkadapterswitch auf dem Netzwerkadapter. Daher darf der Miniporttreiber nur ein Array von NDIS_NIC_SWITCH_VF_INFO Strukturen für jede VF zurückgeben, die auf dem Standardnetzwerkadapterswitch zugeordnet wurde.

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 nur den Standard-Netzwerkadapterswitch, der auf dem Netzwerkadapter erstellt wird. Daher muss dieser Member immer auf NDIS_DEFAULT_SWITCH_ID festgelegt werden.

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_VF_INFO_ARRAY-Struktur bis zum Anfang des ersten Elements gemessen. Jedes Element im Array ist eine NDIS_NIC_SWITCH_VF_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_VF_INFO_ARRAY-Struktur folgen.

ElementSize

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

Hinweise

NDIS gibt eine NDIS_NIC_SWITCH_VF_INFO_ARRAY-Struktur zurück, wenn eine OID-Methodenanforderung von OID_NIC_SWITCH_ENUM_VFS verarbeitet wird. Jedes Element im Array, das der NDIS_NIC_SWITCH_VF_INFO_ARRAY-Struktur folgt, ist ein
NDIS_NIC_SWITCH_VF_INFO Struktur.