NDIS_OPEN_PARAMETERS 構造体 (ndis.h)

NDIS_OPEN_PARAMETERS構造体は、プロトコル ドライバーが NdisOpenAdapterEx 関数を呼び出すときに、開いているパラメーターを定義します。

構文

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;

メンバー

Header

NDIS_OPEN_PARAMETERS構造体のNDIS_OBJECT_HEADER構造体。 Header が指定する構造体の Type メンバーをNDIS_OBJECT_TYPE_OPEN_PARAMETERSに設定し、Revision メンバーを NDIS_OPEN_PARAMETERS_REVISION_1に、Size メンバーをNDIS_SIZEOF_OPEN_PARAMETERS_REVISION_1に設定します。

AdapterName

BindParameters パラメーターの AdapterName メンバーで、NDIS が ProtocolBindAdapterEx に渡したミニポート アダプターの名前を含む Unicode 文字列。 この名前は、物理アダプター (NIC) または中間ドライバーに関連付けられている仮想アダプターを識別できます。

MediumArray

呼び出し元がサポートできるメディアの種類を一覧表示する NdisMediumXxx 値の配列へのポインター。 このリストは、 NDIS_MEDIUM 型のサブセットです。

MediumArraySize

MediumArray メンバー内の要素の数。

SelectedMediumIndex

MediumArray 配列へのインデックスを含むドライバー提供の UINT 変数へのポインター。 NDIS は、基になるドライバーが使用するメディアの種類を識別するこのインデックスを書き込みます。

FrameTypeArray

プロトコル ドライバーが受け取るフレームの種類を指定する、NET_FRAME_TYPE値の配列へのポインター。 フレーム の種類は、イーサネット フレーム内の宛先と送信元の MAC アドレスに従う USHORT 値です。 VLAN タグが存在する場合、この値は宛先、送信元 MAC アドレス、および VLAN タグに従います。 NET_FRAME_TYPEは次のように定義されます。

typedef USHORT  NET_FRAME_TYPE;
typedef NET_FRAME_TYPE *PNET_FRAME_TYPE;

メモ NDIS は、NDIS がプロトコル ドライバーに送信する受信インジケーターを最適化するためのヒントとして、この配列でプロトコル ドライバーが提供するフレームの種類の値を使用します。 NDIS では、プロトコル ドライバーが配列内の型に一致するフレーム型のパケットのみを受信することを保証しません。

 

FrameTypeArraySize

FrameTypeArray メンバー内の要素の数。 この数値は、NDIS_MAX_FRAME_TYPES_PER_OPEN以下である必要があります。

注釈

プロトコル ドライバーは、ミニポート アダプターを開くために NdisOpenAdapterEx 関数を呼び出すときに、NDIS_OPEN_PARAMETERS構造体を渡します。

要件

要件	値
サポートされている最小のクライアント	NDIS 6.0 以降でサポートされています。
Header	ndis.h (Ndis.h を含む)

こちらもご覧ください

NDIS_MEDIUM

NDIS_OBJECT_HEADER

NdisOpenAdapterEx

ProtocolBindAdapterEx