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 指定的结构的 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