DOT11_STATISTICS结构(windot11.h)
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 结构。
微型端口驱动程序必须将 标头 的成员设置为以下值:
类型
此成员必须设置为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 地址匹配的 802.11 MAC 标头中的目标 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 结构。
微型端口驱动程序必须为每个受支持的 PHY 维护 PhyCounters 数组中的条目。 如果 802.11 工作站支持同一类型的多个 PHY,微型端口驱动程序必须为每个类型创建单独的条目。
PhyCounters 数组中的条目必须与驱动程序在查询时返回的受支持 PHY 列表的顺序相同 OID_DOT11_SUPPORTED_PHY_TYPES。
言论
当发生以下情况之一时,微型端口驱动程序必须无条件地将DOT11_STATISTICS结构中的所有计数器设置为零,包括 MAC 层计数器和 PHY 层计数器:
- 调用驱动程序的 MiniportInitializeEx 函数。
- 无论集请求中指定的重置作类型如何,驱动程序的 MiniportOidRequest 函数都会使用 OID 集请求 OID_DOT11_RESET_REQUEST调用。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | 在 Windows Vista 和更高版本的 Windows作系统中可用。 |
标头 | windot11.h (包括 Ndis.h) |