DOT11_STATISTICS结构 (windot11.h)

  • 项目
重要本机 802.11 无线 LAN 接口在 Windows 10 及更高版本中已弃用。 请改用 WLAN 设备驱动程序接口 (WDI) 。 有关 WDI 的详细信息，请参阅 WLAN 通用 Windows 驱动程序模型。

DOT11_STATISTICS 结构记录 802.11 接口的统计计数器。

语法

typedef struct DOT11_STATISTICS {
  NDIS_OBJECT_HEADER         Header;
  ULONGLONG                  ullFourWayHandshakeFailures;
  ULONGLONG                  ullTKIPCounterMeasuresInvoked;
  ULONGLONG                  ullReserved;
  DOT11_MAC_FRAME_STATISTICS MacUcastCounters;
  DOT11_MAC_FRAME_STATISTICS MacMcastCounters;
  DOT11_PHY_FRAME_STATISTICS PhyCounters[1];
} DOT11_STATISTICS, *PDOT11_STATISTICS;

成员

Header

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

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

类型

此成员必须设置为 NDIS_OBJECT_TYPE_DEFAULT。

修订

此成员必须设置为 DOT11_STATISTICS_REVISION_1。

大小

此成员必须设置为 sizeof(DOT11_STATISTICS)。

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

ullFourWayHandshakeFailures

802.11 工作站在 Wi-Fi 受保护的访问 (WPA) 或可靠安全网络关联期间遇到的四向握手失败次数， (RSNA) 身份验证。

如果 802.11 工作站未执行 WPA 或 RSNA 身份验证，则应将此成员设置为 DOT11_STATISTICS_UNKNOWN。

ullTKIPCounterMeasuresInvoked

802.11 工作站在消息完整性代码 (MIC) 故障后调用对策的次数。

如果 802.11 工作站未执行 TKIP 对策，则应将此成员设置为 DOT11_STATISTICS_UNKNOWN。

ullReserved

此成员保留供操作系统使用。 微型端口驱动程序不得写入此成员。

MacUcastCounters

MAC 层计数器基于 802.11 工作站发送或接收的单播数据包。 此成员的数据结构为 DOT11_MAC_FRAME_STATISTICS 结构。

注意  

对于 802.11 MAC 标头中目标 MAC 地址与 802.11 工作站的 MAC 地址匹配的数据包，接收的单播数据包的计数器必须递增。

MacMcastCounters

MAC 层计数器基于 802.11 工作站发送或接收的多播或广播数据包。 此成员的数据结构为 DOT11_MAC_FRAME_STATISTICS 结构。

注意  

对于 802.11 MAC 标头中的目标 MAC 地址与 802.11 工作站的多播地址列表中的条目匹配的数据包，接收的多播或广播数据包的计数器必须仅递增。 有关多播地址列表的详细信息，请参阅 OID_DOT11_MULTICAST_LIST。

PhyCounters[1]

PHY 层计数器的数组。 此数组中的每个条目的格式设置为 DOT11_PHY_FRAME_STATISTICS 结构。

微型端口驱动程序必须在 PhyCounters 数组中为每个受支持的 PHY 维护一个条目。 如果 802.11 工作站支持同一类型的多个 PHY，微型端口驱动程序必须为每个单元创建单独的条目。

PhyCounters 数组中的条目必须与驱动程序查询时返回的受支持的 PHY 列表的顺序相同 OID_DOT11_SUPPORTED_PHY_TYPES。

注解

发生以下任一情况时，微型端口驱动程序必须无条件地将DOT11_STATISTICS结构中的所有计数器（包括 MAC 层计数器和 PHY 层计数器）设置为零：

有关 Native 802.11 微型端口驱动程序收集的统计信息的详细信息，请参阅 Native 802.11 Statistics。

要求

要求 值
最低受支持的客户端 在 Windows Vista 和更高版本的 Windows 操作系统中可用。
标头 windot11.h (包括 Ndis.h)

另请参阅

OID_DOT11_STATISTICS