Auf Englisch lesen

Freigeben über


NDIS_NIC_SWITCH_VF_INFO_ARRAY Struktur (ntddndis.h)

Die NDIS_NIC_SWITCH_VF_INFO_ARRAY-Struktur gibt ein Array an. Jedes Element im Array gibt die Attribute einer virtuellen PCI Express(PCIe)-Funktionen (VF) an, die auf einem Netzwerkadapter aktiviert und zugewiesen 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;

Angehörige

Header

Der Typ, die Überarbeitung und die Größe der NDIS_NIC_SWITCH_VF_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_VF_INFO_ARRAY-Struktur anzugeben, legt NDIS den Revision Member 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 den Size Member auf NDIS_SIZEOF_NIC_SWITCH_VF_INFO_ARRAY_REVISION_1 fest.

Flags

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

NDIS_NIC_SWITCH_VF_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH

Wenn dieses Kennzeichen festgelegt ist, darf der Miniporttreiber nur ein Array von NDIS_NIC_SWITCH_VF_INFO Strukturen für VFs zurückgeben, die auf dem netzwerkadapter switch zugewiesen wurden, der vom SwitchId Member angegeben wurde. Weitere Informationen finden Sie im Abschnitt "Hinweise".

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

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

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.

Hinweis Ab Windows Server 2012 unterstützt die SR-IOV-Schnittstelle nur den Standardnetzwerkadapterswitch, der auf dem Netzwerkadapter erstellt wird. Daher muss dieses Element immer auf NDIS_DEFAULT_SWITCH_ID festgelegt werden.
 

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

ElementSize

Ein ULONG-Wert, der die Größe jedes Elements in Bytes angibt, die der NDIS_NIC_SWITCH_VF_INFO_ARRAY Struktur folgen.

Bemerkungen

NDIS gibt eine NDIS_NIC_SWITCH_VF_INFO_ARRAY Struktur zurück, wenn sie eine OID-Methodenanforderung von OID_NIC_SWITCH_ENUM_VFSverarbeitet. Jedes Element im Array, das auf die NDIS_NIC_SWITCH_VF_INFO_ARRAY Struktur folgt, ist eine
NDIS_NIC_SWITCH_VF_INFO Struktur.

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_VF_INFO

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_ENUM_VFS