NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES 结构 (ndis.h)

项目
08/07/2023

重要本机 802.11 无线 LAN 接口在 Windows 10 及更高版本中已弃用。请改用 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 结构。

微型端口驱动程序必须将 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

指定微型端口驱动程序支持 Extensible Access Point (ExtAP) 操作模式。

此值从 Windows 7 开始可用。

DOT11_OPERATION_MODE_EXTENSIBLE_STATION

指定微型端口驱动程序支持 Extensible Station (ExtSTA) 操作模式。

DOT11_OPERATION_MODE_NETWORK_MONITOR

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

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

NumOfTXBuffers

802.11 工作站在其传输队列中可以容纳的数据包 (MSDU (MAC) ) 服务数据单元的最大媒体访问控制数。微型端口驱动程序必须支持最小传输队列深度 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 结构的指针，该结构指定在 Extensible Station (ExtSTA) 模式下运行时微型端口驱动程序和 802.11 工作站的属性。有关此操作模式的详细信息，请参阅可扩展工作站操作模式。

VWiFiAttributes

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

此成员从 Windows 7 开始可用。

ExtAPAttributes

指向 DOT11_EXTAP_ATTRIBUTES 结构的指针，该结构指定微型端口驱动程序和 802.11 工作站在 Extensible Access Point (ExtAP) 模式下运行时的属性。

此成员从 Windows 7 开始可用。

WFDAttributes

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

此成员从Windows 8开始可用。

注解

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

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