NDIS_SWITCH_NIC_ARRAY Struktur (ntddndis.h)

Artikel
02/07/2025

Die NDIS_SWITCH_NIC_ARRAY Struktur gibt ein Array von Netzwerkadapterkonfigurationsparametern an. Jedes Element im Array gibt die Parameter für einen Netzwerkadapter an, der mit einem Port auf einem Hyper-V erweiterbaren Switch verbunden ist. Jedes Element ist als NDIS_SWITCH_NIC_PARAMETERS Struktur formatiert.

Syntax

typedef struct _NDIS_SWITCH_NIC_ARRAY {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  USHORT             FirstElementOffset;
  ULONG              NumElements;
  ULONG              ElementSize;
} NDIS_SWITCH_NIC_ARRAY, *PNDIS_SWITCH_NIC_ARRAY;

Angehörige

Header

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

Das element TypeHeader muss auf NDIS_OBJECT_TYPE_DEFAULT festgelegt werden. Um die Version der NDIS_SWITCH_NIC_ARRAY-Struktur anzugeben, muss das Revision Member des Header- auf den folgenden Wert festgelegt werden:

NDIS_SWITCH_NIC_ARRAY_REVISION_1

Originalversion für NDIS 6.30 und höher.

Legen Sie das Size Member auf NDIS_SIZEOF_NDIS_SWITCH_NIC_ARRAY_REVISION_1 fest.

Flags

Ein ULONG-Wert, der ein bitweises ODER von Flags enthält. Dieses Mitglied ist für NDIS reserviert.

FirstElementOffset

Ein USHORT-Wert, der den Offset in Bytes angibt, auf das erste Element in einem Array von Elementen, die dieser Struktur folgen. Der Offset wird vom Anfang der NDIS_SWITCH_NIC_ARRAY Struktur bis zum Anfang des ersten Elements gemessen. Jedes Element im Array ist eine NDIS_SWITCH_NIC_PARAMETERS Struktur.

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

NumElements

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

ElementSize

Ein ULONG-Wert, der die Größe der NDIS_SWITCH_NIC_PARAMETERS Elemente in Bytes angibt, die der NDIS_SWITCH_NIC_ARRAY Struktur folgen.

Bemerkungen

Die NDIS_SWITCH_NIC_ARRAY Struktur wird in OID-Abfrageanforderungen von OID_SWITCH_NIC_ARRAYzurückgegeben. Ein Array von NDIS_SWITCH_NIC_PARAMETERS Strukturen folgt der NDIS_SWITCH_NIC_ARRAY Struktur im Informationspuffer, die der OID-Abfrageanforderung zugeordnet ist. Das InformationBuffer Member der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf diesen Informationspuffer.

Erweiterbare Switcherweiterungen können mithilfe des NDIS_SWITCH_NIC_AT_ARRAY_INDEX-Makros auf einzelne NDIS_SWITCH_NIC_PARAMETERS Strukturen innerhalb einer NDIS_SWITCH_NIC_ARRAY Struktur zugreifen.