Share via

windot11.h) (DOT11_PHY_FRAME_STATISTICS 结构

  • 项目
重要本机 802.11 无线 LAN 接口在 Windows 10 及更高版本中已弃用。 请改用 WLAN 设备驱动程序接口 (WDI) 。 有关 WDI 的详细信息，请参阅 WLAN 通用 Windows 驱动程序模型。
 
DOT11_PHY_FRAME_STATISTICS结构记录 802.11 工作站的 IEEE 物理 (PHY) 层的统计计数器。

语法

typedef struct DOT11_PHY_FRAME_STATISTICS {
  ULONGLONG ullTransmittedFrameCount;
  ULONGLONG ullMulticastTransmittedFrameCount;
  ULONGLONG ullFailedCount;
  ULONGLONG ullRetryCount;
  ULONGLONG ullMultipleRetryCount;
  ULONGLONG ullMaxTXLifetimeExceededCount;
  ULONGLONG ullTransmittedFragmentCount;
  ULONGLONG ullRTSSuccessCount;
  ULONGLONG ullRTSFailureCount;
  ULONGLONG ullACKFailureCount;
  ULONGLONG ullReceivedFrameCount;
  ULONGLONG ullMulticastReceivedFrameCount;
  ULONGLONG ullPromiscuousReceivedFrameCount;
  ULONGLONG ullMaxRXLifetimeExceededCount;
  ULONGLONG ullFrameDuplicateCount;
  ULONGLONG ullReceivedFragmentCount;
  ULONGLONG ullPromiscuousReceivedFragmentCount;
  ULONGLONG ullFCSErrorCount;
} DOT11_PHY_FRAME_STATISTICS, *PDOT11_PHY_FRAME_STATISTICS;

成员

ullTransmittedFrameCount

802.11 工作站的 IEEE PHY 层已成功传输的 MSDU 数据包和 MMPDU 帧数。

ullMulticastTransmittedFrameCount

802.11 工作站的 IEEE PHY 层已成功传输的多播或广播 MSDU 数据包和 MMPDU 帧数。

ullFailedCount

802.11 工作站在超过 802.11 IEEE dot11ShortRetryLimit 或 dot11LongRetryLimit MIB 计数器定义的重试限制后未能传输的 MSDU 数据包和 MMPDU 帧数。 有关这些 MIB 计数器的详细信息，请参阅 OID_DOT11_SHORT_RETRY_LIMIT 或 OID_DOT11_LONG_RETRY_LIMIT。

ullRetryCount

802.11 工作站在一次或多次尝试后成功传输的 MSDU 数据包和 MMPDU 帧数。

ullMultipleRetryCount

802.11 工作站在多次重新传输尝试后成功传输的 MSDU 数据包和 MMPDU 帧数。

对于 MSDU 数据包，微型端口驱动程序必须为在需要重新传输一个或多个 MPDU 片段后成功传输的每个数据包递增此计数器。

ullMaxTXLifetimeExceededCount

由于 IEEE 802.11 dot11MaxTransmitMSDULifetime MIB 对象定义的超时，802.11 工作站无法传输的 MSDU 数据包和 MMPDU 帧数。 有关此 MIB 对象的详细信息，请参阅 OID_DOT11_MAX_TRANSMIT_MSDU_LIFETIME。

ullTransmittedFragmentCount

802.11 工作站通过接收的 802.11 ACK 帧传输和确认的 MPDU 帧数。

ullRTSSuccessCount

802.11 工作站收到“清除发送 (CTS) 帧以响应请求发送 (RTS) 帧的次数。

ullRTSFailureCount

802.11 工作站未收到 CTS 帧以响应 RTS 帧的次数。

ullACKFailureCount

802.11 站预期且未收到确认 (ACK) 帧的次数。

ullReceivedFrameCount

802.11 工作站已成功接收的 MSDU 数据包和 MMPDU 帧总数。

对于 MSDU 数据包，微型端口驱动程序必须为接收 MPDU 片段并通过帧的每个数据包递增此计数器，检查序列 (FCS) 验证和重播检测。 无论收到的 MSDU 数据包或 MPDU 片段是否未能通过 MAC 层密码解密，微型端口驱动程序都必须递增此成员。

此计数器是可选的。 如果 NIC 不支持此计数器，微型端口驱动程序应将此成员设置为 DOT11_STATISTICS_UNKNOWN。

ullMulticastReceivedFrameCount

802.11 工作站已成功接收的多播或广播 MSDU 数据包和 MMPDU 帧数。

对于 MSDU 数据包，微型端口驱动程序必须为每个已接收 MPDU 片段并通过 FCS 验证和重播检测的数据包递增此计数器。 无论收到的 MSDU 数据包或 MPDU 片段是否未能通过 MAC 层密码解密，微型端口驱动程序都必须递增此成员。

此计数器是可选的。 如果 NIC 不支持此计数器，微型端口驱动程序应将此成员设置为 DOT11_STATISTICS_UNKNOWN。

ullPromiscuousReceivedFrameCount

启用混杂数据包筛选器时，802.11 工作站接收的 MSDU 数据包或 MMPDU 帧数。 有关数据包筛选器的详细信息，请参阅 OID_GEN_CURRENT_PACKET_FILTER。

如果启用了混杂数据包筛选器，则微型端口驱动程序只能为未启用筛选器时被拒绝的接收 MSDU 数据包或 MMPDU 帧递增此计数器。 驱动程序不得针对以下原因递增此计数器：

  • 具有与 802.11 工作站的 MAC 地址匹配的目标 MAC 地址的单播 MSDU 数据包或 MMPDU 帧。
  • 使用与 802.11 工作站的多播地址列表中的条目匹配的目标 MAC 地址的多播或广播 MSDU 数据包或 MMPDU 帧。 有关多播地址列表的详细信息，请参阅 OID_DOT11_MULTICAST_LIST。

ullMaxRXLifetimeExceededCount

如果 802.11 工作站因 IEEE 802.11 dot11MaxReceiveLifetime MIB 对象定义的超时而丢弃的 MSDU 数据包和 MMPDU 帧，则为数。 有关此 MIB 对象的详细信息，请参阅 OID_DOT11_MAX_RECEIVE_LIFETIME。

ullFrameDuplicateCount

802.11 工作站接收的重复 MPDU 帧数。 802.11 工作站通过 802.11 MAC 标头的序列控制字段确定重复帧。

ullReceivedFragmentCount

802.11 工作站为 MSDU 数据包或 MMPDU 帧接收的 MPDU 帧数。

ullPromiscuousReceivedFragmentCount

启用混杂数据包筛选器时，802.11 工作站接收的 MSDU 数据包或 MMPDU 帧的 MPDU 帧数。 有关数据包筛选器的详细信息，请参阅 OID_GEN_CURRENT_PACKET_FILTER。

如果启用了混杂数据包筛选器，微型端口驱动程序必须仅针对未启用筛选器而被拒绝的已接收 MPDU 帧递增此计数器。 驱动程序不得针对以下原因递增此计数器：

  • 具有与 802.11 工作站的 MAC 地址匹配的目标 MAC 地址的单播 MPDU 帧。
  • 具有与 802.11 工作站的多播地址列表中的条目匹配的目标 MAC 地址的多播或广播 MPDU 帧。 有关多播地址列表的详细信息，请参阅 OID_DOT11_MULTICAST_LIST。

ullFCSErrorCount

802.11 工作站收到并出现 FCS 错误的 MPDU 帧数。

注解

此结构的成员用于记录以下项的 PHY 级统计信息：

  • 802.11 MSDU 数据包。
  • 802.11 MMPDU 帧。
  • 802.11 MPDU 帧。 MPDU 帧计数器必须包括为 MSDU 数据包或 MMPDU 帧发送的所有 MPDU 片段

要求

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

另请参阅

可扩展工作站 PHY 统计信息

OID_DOT11_STATISTICS

DOT11_STATISTICS

本机 802.11 统计信息