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

AdapterName

Unicode 字串，其中包含 NDIS 在 BindParameters 參數的 AdapterName 成員中傳遞至 ProtocolBindAdapterEx 的迷你埠配接器名稱。 此名稱可以識別實體適配卡 (，也就是 NIC) 或與中繼驅動程式相關聯的虛擬適配卡。

MediumArray

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

MediumArraySize

MediumArray 成員中的元素數目。

SelectedMediumIndex

驅動程式提供的 UINT 變數指標，其中包含 MediumArray 陣列中的索引。 NDIS 會寫入此索引，以識別基礎驅動程式所使用的媒體類型。

FrameTypeArray

NET_FRAME_TYPE值的陣列指標，指定您想要通訊協定驅動程式接收的框架類型。 框架類型是一個 USHORT 值，緊接乙太網路畫面格中的目的地和來源 MAC 位址。 在 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 和更新版本支援。
標頭	ndis.h (包括 Ndis.h)

另請參閱

NDIS_MEDIUM

NDIS_OBJECT_HEADER

NdisOpenAdapterEx

ProtocolBindAdapterEx