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

一个 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