NDIS_OPEN_PARAMETERS結構（ndis.h）

當通訊協定驅動程式呼叫 NdisOpenAdapterEx 函式時，NDIS_OPEN_PARAMETERS結構會定義開啟的參數。

語法

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 結構。 將 標頭 指定為NDIS_OBJECT_TYPE_OPEN_PARAMETERS的 Type 成員、將 Revision 成員設定為 NDIS_OPEN_PARAMETERS_REVISION_1，並將 Size 成員設定為 NDIS_SIZEOF_OPEN_PARAMETERS_REVISION_1。

AdapterName

Unicode 字串，其中包含傳遞至 protocolBindAdapterEx AdapterNameBindParameters 參數成員之 NDIS 的迷你埠配接器名稱。 此名稱可以識別實體配接器（也就是 NIC），或與中繼驅動程式相關聯的虛擬配接器。

MediumArray

NdisMediumXxx 值的指標，其中列出呼叫者可支援的媒體類型。 此清單是 NDIS_MEDIUM 類型的子集。

MediumArraySize

MediumArray 成員中的元素數目。

SelectedMediumIndex

驅動程式提供的 UINT 變數指標，其中包含 MediumArray 陣列中的索引。 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;

Note NDIS 會使用此數位中通訊協定驅動程式提供的框架類型值作為提示，以優化 NDIS 傳送至通訊協定驅動程式的接收指示。 NDIS 不保證通訊協定驅動程式只會接收與數位中類型相符之框架類型的封包。

 

FrameTypeArraySize

FrameTypeArray 成員中的元素數目。 這個數字必須等於或小於 NDIS_MAX_FRAME_TYPES_PER_OPEN。

言論

通訊協議驅動程式會在呼叫 NdisOpenAdapterEx 函式以開啟迷你埠配接器時，傳遞NDIS_OPEN_PARAMETERS結構。

要求

要求	價值
最低支援的用戶端	NDIS 6.0 和更新版本支援。
標頭	ndis.h （包括 Ndis.h）

另請參閱

NDIS_MEDIUM

NDIS_OBJECT_HEADER

NdisOpenAdapterEx

ProtocolBindAdapterEx