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 结构。
微型端口驱动程序必须将 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 层计数器）设置为零：
- 调用驱动程序的 MiniportInitializeEx 函数。
- 驱动程序的 MiniportOidRequest 函数使用 OID_DOT11_RESET_REQUEST 的 OID 集请求调用，而不考虑在设置请求中指定的重置操作类型。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 在 Windows Vista 和更高版本的 Windows 操作系统中可用。 |
| 标头 | windot11.h (包括 Ndis.h) |