NDIS_SWITCH_PORT_ARRAY-Struktur (ntddndis.h)

Artikel
02/29/2024

Die NDIS_SWITCH_PORT_ARRAY-Struktur gibt ein Array von Portkonfigurationsparametern an. Jedes Element im Array gibt die Parameter für einen erweiterbaren Hyper-V-Switchport an. Jedes Element ist als NDIS_SWITCH_PORT_PARAMETERS-Struktur formatiert.

Syntax

typedef struct _NDIS_SWITCH_PORT_ARRAY {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  USHORT             FirstElementOffset;
  ULONG              NumElements;
  ULONG              ElementSize;
} NDIS_SWITCH_PORT_ARRAY, *PNDIS_SWITCH_PORT_ARRAY;

Member

Header

Der Typ, die Revision und die Größe der NDIS_SWITCH_PORT_ARRAY-Struktur . Dieses Element ist als NDIS_OBJECT_HEADER-Struktur formatiert.

Das Type-Element von Header muss auf NDIS_OBJECT_TYPE_DEFAULT festgelegt werden. Um die Version der NDIS_SWITCH_PORT_ARRAY-Struktur anzugeben, muss der Revisionsmember des Headers auf den folgenden Wert festgelegt werden:

NDIS_SWITCH_PORT_ARRAY_REVISION_1

Ursprüngliche Version für NDIS 6.30 und höher.

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

Flags

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

FirstElementOffset

Ein USHORT-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_SWITCH_PORT_ARRAY-Struktur bis zum Anfang des ersten Elements gemessen. Jedes Element im Array ist eine NDIS_SWITCH_PORT_PARAMETERS-Struktur .

Hinweis Wenn NumElements auf 0 festgelegt ist, wird dieses Element ignoriert.

NumElements

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

ElementSize

Ein ULONG-Wert, der die Größe der NDIS_SWITCH_PORT_PARAMETERS Elemente angibt, die der NDIS_SWITCH_PORT_ARRAY-Struktur folgen.

Hinweise

Die NDIS_SWITCH_PORT_ARRAY-Struktur wird in OID-Abfrageanforderungen von OID_SWITCH_PORT_ARRAY zurückgegeben. Ein Array von NDIS_SWITCH_PORT_PARAMETERS Strukturen folgt der NDIS_SWITCH_PORT_ARRAY-Struktur im Informationspuffer, die diesen OID-Abfrageanforderungen zugeordnet ist. Das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf diesen Informationspuffer.

Erweiterbare Switcherweiterungen können mithilfe des makros NDIS_SWITCH_PORT_AT_ARRAY_INDEX auf einzelne NDIS_SWITCH_PORT_PARAMETERS Elemente innerhalb einer NDIS_SWITCH_PORT_ARRAY-Struktur zugreifen.