NDIS_NIC_SWITCH_INFO_ARRAY-Struktur (ntddndis.h)

Artikel
08/07/2023

Die NDIS_NIC_SWITCH_INFO_ARRAY-Struktur gibt ein Array an. Jedes Element im Array gibt die Attribute eines Netzwerkadapterswitches an, der auf dem Netzwerkadapter erstellt wurde.

Syntax

typedef struct _NDIS_NIC_SWITCH_INFO_ARRAY {
  NDIS_OBJECT_HEADER Header;
  ULONG              FirstElementOffset;
  ULONG              NumElements;
  ULONG              ElementSize;
} NDIS_NIC_SWITCH_INFO_ARRAY, *PNDIS_NIC_SWITCH_INFO_ARRAY;

Member

Header

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

NDIS_NIC_SWITCH_INFO_ARRAY_REVISION_1

Originalversion für NDIS 6.30.

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

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

ElementSize

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

Hinweise

NDIS gibt eine NDIS_NIC_SWITCH_INFO_ARRAY-Struktur auf folgende Weise zurück:

Wenn NDIS eine OID-Abfrageanforderung von OID_NIC_SWITCH_ENUM_SWITCHES verarbeitet, wird ein Zeiger auf eine NDIS_NIC_SWITCH_INFO_ARRAY-Struktur im InformationBuffer-Member des NDIS_OID_REQUEST zurückgegeben.
Wenn NDIS die ProtocolBindAdapterEx-Funktion aufruft, übergibt NDIS einen Zeiger auf eine NDIS_BIND_PARAMETERS-Struktur im BindParameters-Parameter . NDIS legt den NicSwitchArray-Member der NDIS_BIND_PARAMETERS-Struktur auf einen Zeiger auf eine NDIS_NIC_SWITCH_INFO_ARRAY-Struktur fest.
Wenn NDIS die FilterAttach-Funktion aufruft, übergibt NDIS einen Zeiger auf eine NDIS_FILTER_ATTACH_PARAMETERS-Struktur im AttachParameters-Parameter . NDIS legt den NicSwitchArray-Member der NDIS_FILTER_ATTACH_PARAMETERS-Struktur auf einen Zeiger auf eine NDIS_NIC_SWITCH_INFO_ARRAY-Struktur fest.

Jedes Element im Array, das der NDIS_NIC_SWITCH_INFO_ARRAY-Struktur folgt, ist eine NDIS_NIC_SWITCH_INFO-Struktur .

Hinweis Ab NDIS 6.30 wird nur der NDIS_NIC_SWITCH_INFO , der die Informationen zum Standard-Netzwerkadapterswitch beschreibt, über eine OID-Abfrageanforderung von OID_NIC_SWITCH_ENUM_SWITCHES zurückgegeben.