NDIS_OPEN_PARAMETERS Struktur (ndis.h)

Die NDIS_OPEN_PARAMETERS-Struktur definiert die offenen 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;

Angehörige

Header

Die NDIS_OBJECT_HEADER Struktur für die NDIS_OPEN_PARAMETERS Struktur. Legen Sie das element Type der Struktur fest, das Header- angibt, NDIS_OBJECT_TYPE_OPEN_PARAMETERS, das Revisionselement auf NDIS_OPEN_PARAMETERS_REVISION_1 und das Size member to the NDIS_SIZEOF_OPEN_PARAMETERS_REVISION_1.

AdapterName

Eine Unicode-Zeichenfolge, die den Namen des Miniportadapters enthält, den NDIS an ProtocolBindAdapterEx im AdapterName Member des BindParameters Parameter ü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 NdisMedium-Xxx--Werten, die die Typen von Medien auflisten, die der Aufrufer unterstützen kann. Diese Liste ist eine Teilmenge der NDIS_MEDIUM Typen.

MediumArraySize

Die Anzahl der Elemente im MediumArray Member.

SelectedMediumIndex

Ein Zeiger auf eine vom Treiber bereitgestellte UINT-Variable, die einen Index im 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, wobei die Frametypen angegeben werden, die der Protokolltreiber empfangen soll. Der Frametyp ist ein USHORT-Wert, der auf die Ziel- und Quell-MAC-Adresse in Ethernet-Frames folgt. In Anwesenheit von VLAN-Tags folgt dieser Wert dem Ziel-, MAC-Quell- und VLAN-Tag. NET_FRAME_TYPE ist 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 Member. Diese Zahl muss gleich oder kleiner als NDIS_MAX_FRAME_TYPES_PER_OPEN sein.

Bemerkungen

Ein Protokolltreiber übergibt eine NDIS_OPEN_PARAMETERS Struktur, wenn sie die NdisOpenAdapterEx--Funktion aufruft, um einen Miniportadapter zu öffnen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Unterstützt in NDIS 6.0 und höher.
Header-	ndis.h (include Ndis.h)

Siehe auch

NDIS_MEDIUM

NDIS_OBJECT_HEADER

NdisOpenAdapterEx

ProtocolBindAdapterEx-