NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES结构（ndis.h）

项目
02/07/2025

重要 Windows 10 及更高版本中弃用了 Native 802.11 无线 LAN 接口。请改用 WLAN 设备驱动程序接口（WDI）。有关 WDI 的详细信息，请参阅 WLAN 通用 Windows 驱动程序模型。

NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES结构定义 Native 802.11 微型端口驱动程序和 802.11 工作站的物理和作属性。

语法

typedef struct {
  NDIS_OBJECT_HEADER       Header;
  ULONG                    OpModeCapability;
  ULONG                    NumOfTXBuffers;
  ULONG                    NumOfRXBuffers;
  BOOLEAN                  MultiDomainCapabilityImplemented;
  ULONG                    NumSupportedPhys;
  PDOT11_PHY_ATTRIBUTES    SupportedPhyAttributes;
  PDOT11_EXTSTA_ATTRIBUTES ExtSTAAttributes;
#if (NDIS_SUPPORT_NDIS620)
  PDOT11_VWIFI_ATTRIBUTES  VWiFiAttributes;
  PDOT11_EXTAP_ATTRIBUTES  ExtAPAttributes;
#endif
#if (NDIS_SUPPORT_NDIS630)
  PDOT11_WFD_ATTRIBUTES    WFDAttributes;
#endif
} NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES, *PNDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES;

成员

Header

NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES结构的类型、修订和大小。此成员的格式设置为 NDIS_OBJECT_HEADER 结构。

微型端口驱动程序必须将标头的成员设置为以下值：

类型

此成员必须设置为NDIS_OBJECT_TYPE_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES。

校订

对于 Windows Vista 或 Windows Server 2008作系统，此成员必须设置为NDIS_MINIPORT_ADAPTER_802_11_ATTRIBUTES_REVISION_1。

对于更高版本的 Windows作系统，此成员必须设置为NDIS_MINIPORT_ADAPTER_802_11_ATTRIBUTES_REVISION_2。

大小

对于 Windows Vista 或 Windows Server 2008作系统，此成员必须设置为NDIS_SIZEOF_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES_REVISION_1。

对于更高版本的 Windows作系统，此成员必须设置为NDIS_SIZEOF_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES_REVISION_2。

有关这些成员的详细信息，请参阅 NDIS_OBJECT_HEADER。

OpModeCapability

微型端口驱动程序支持的作模式的位掩码。此位掩码通过以下内容定义：

DOT11_OPERATION_MODE_EXTENSIBLE_AP

指定微型端口驱动程序支持可扩展接入点（ExtAP）作模式。

此值从 Windows 7 开始可用。

DOT11_OPERATION_MODE_EXTENSIBLE_STATION

指定微型端口驱动程序支持可扩展工作站（ExtSTA）作模式。

DOT11_OPERATION_MODE_NETWORK_MONITOR

指定微型端口驱动程序支持网络监视器（NetMon）作模式。

有关作模式的详细信息，请参阅本机 802.11作模式。

NumOfTXBuffers

802.11 工作站在其传输队列中可以容纳的最大媒体访问控制（MAC）服务数据单元（MSDU）数据包数。微型端口驱动程序必须支持最小传输队列深度为 64。

此成员的值不得包含 802.11 工作站用于自行发送数据包的传输缓冲区数，例如信标数据包或 802.11 控制数据包。

NumOfRXBuffers

802.11 工作站在其接收队列中可以缓冲的最大 MSDU 数据包数。微型端口驱动程序必须支持最小接收队列深度为 64。

MultiDomainCapabilityImplemented

一个布尔值，如果 TRUE，则指定 802.11 工作站可以在多个监管域中运行。有关 802.11 法规域的详细信息，请参阅 IEEE 802.11d-2001 标准。

NumSupportedPhys

802.11 站的 PHY 数量。

SupportedPhyAttributes

指向 DOT11_PHY_ATTRIBUTES 结构的数组的指针。此数组必须具有 NumSupportedPhys 条目，并且必须按与通过查询返回的 PHY 类型列表相同的顺序排序 OID_DOT11_SUPPORTED_PHY_TYPES。

ExtSTAAttributes

指向 DOT11_EXTSTA_ATTRIBUTES 结构的指针，该结构指定在可扩展工作站（ExtSTA）模式下运行时微型端口驱动程序和 802.11 工作站的属性。有关此作模式的详细信息，请参阅可扩展工作站作模式。

VWiFiAttributes

指向 DOT11_VWIFI_ATTRIBUTES 结构的指针，该结构指定在虚拟 WiFi 模式下运行时微型端口驱动程序和 802.11 工作站的属性。

此成员从 Windows 7 开始可用。

ExtAPAttributes

指向 DOT11_EXTAP_ATTRIBUTES 结构的指针，该结构在可扩展接入点（ExtAP）模式下运行时指定微型端口驱动程序和 802.11 工作站的属性。

此成员从 Windows 7 开始可用。

WFDAttributes

指向 DOT11_WFD_ATTRIBUTES 结构的指针，该结构指定微型端口驱动程序和 802.11 工作站在 Wi-Fi Direct （WFD）模式下运行时的属性。

此成员从 Windows 8 开始可用。

言论

调用其 MiniportInitializeEx 函数时，微型端口驱动程序必须调用 NdisMSetMiniportAttributes 函数，以定义驱动程序的 Native 802.11 属性和 802.11 工作站。微型端口驱动程序在调用 NdisMSetMiniportAttributes时，必须遵循以下准则：

MiniportAttributes 参数必须设置为驱动程序分配的内存块的地址，该内存块包含NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES结构以及 ExtSTA 属性和 PHY 属性数组。
SupportedPhyAttributes 成员必须是 DOT11_PHY_ATTRIBUTES 结构数组的地址。此数组必须位于 MiniportAttributes 参数引用的驱动程序分配内存块中。
ExtSTAAttributes 成员必须是 DOT11_EXTSTA_ATTRIBUTES 结构的地址。此结构必须位于 MiniportAttributes 参数引用的驱动程序分配内存块中。