NDIS_OPEN_PARAMETERS-Struktur (ndis.h)

Artikel
02/26/2024

Die NDIS_OPEN_PARAMETERS-Struktur definiert die geöffneten Parameter, wenn ein Protokolltreiber die NdisOpenAdapterEx-Funktion aufruft .

Syntax

typedef struct _NDIS_OPEN_PARAMETERS {
  NDIS_OBJECT_HEADER Header;
  PNDIS_STRING       AdapterName;
  PNDIS_MEDIUM       MediumArray;
  UINT               MediumArraySize;
  PUINT              SelectedMediumIndex;
  PNET_FRAME_TYPE    FrameTypeArray;
  UINT               FrameTypeArraySize;
} NDIS_OPEN_PARAMETERS, *PNDIS_OPEN_PARAMETERS;

Member

Header

Die NDIS_OBJECT_HEADER-Struktur für die NDIS_OPEN_PARAMETERS-Struktur. Legen Sie den Typmember der Struktur, die Header für NDIS_OBJECT_TYPE_OPEN_PARAMETERS angibt, das Revisionselement auf NDIS_OPEN_PARAMETERS_REVISION_1 und das Size-Element auf den NDIS_SIZEOF_OPEN_PARAMETERS_REVISION_1 fest.

AdapterName

Eine Unicode-Zeichenfolge, die den Namen des Miniportadapters enthält, den NDIS im AdapterName-Member des BindParameters-Parameters an ProtocolBindAdapterEx übergeben hat. Dieser Name kann einen physischen Adapter (d. h. eine NIC) oder einen virtuellen Adapter identifizieren, der einem Zwischentreiber zugeordnet ist.

MediumArray

Ein Zeiger auf ein Array von NdisMediumXxx-Werten , das die Medientypen auflistet, die der Aufrufer unterstützen kann. Diese Liste ist eine Teilmenge der NDIS_MEDIUM Typen.

MediumArraySize

Die Anzahl der Elemente im MediumArray-Element .

SelectedMediumIndex

Ein Zeiger auf eine vom Treiber bereitgestellte UINT-Variable, die einen Index in das MediumArray-Array enthält. NDIS schreibt diesen Index, der den Vom zugrunde liegenden Treiber verwendeten Medientyp identifiziert.

FrameTypeArray

Ein Zeiger auf ein Array von NET_FRAME_TYPE Werten, der die Frametypen angibt, die vom Protokolltreiber empfangen werden sollen. Der Frametyp ist ein USHORT-Wert, der der Ziel- und Quell-MAC-Adresse in Ethernet-Frames folgt. Bei Vorhandensein von VLAN-Tags folgt dieser Wert dem Ziel, der MAC-Quelladresse und dem VLAN-Tag. NET_FRAME_TYPE wird wie folgt definiert:

typedef USHORT  NET_FRAME_TYPE;
typedef NET_FRAME_TYPE *PNET_FRAME_TYPE;

Hinweis NDIS verwendet die Frametypwerte, die der Protokolltreiber in diesem Array bereitstellt, als Hinweis, um die Empfangsanzeigen zu optimieren, die NDIS an den Protokolltreiber sendet. NDIS garantiert nicht, dass ein Protokolltreiber nur Pakete mit Frametypen empfängt, die den Typen im Array entsprechen.

FrameTypeArraySize

Die Anzahl der Elemente im FrameTypeArray-Element . Diese Zahl muss gleich oder kleiner als NDIS_MAX_FRAME_TYPES_PER_OPEN sein.