DOT11_PHY_FRAME_STATISTICS结构(windot11.h)

重要

WiFiCx 是 Windows 11 中发布的新 Wi-Fi 驱动程序模型。 建议使用 WiFiCx 来利用最新功能。 WDI 驱动程序模型现在处于维护模式,并且仅接收高优先级修补程序。

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 IEEE dot11ShortRetryLimitdot11LongRetryLimit MIB 计数器定义的重试限制后,802.11 工作站未能传输的 MSDU 数据包数和 MMPDU 帧数。 有关这些 MIB 计数器的详细信息,请参阅 OID_DOT11_SHORT_RETRY_LIMITOID_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 工作站在响应 RTS 帧时未收到 CTS 帧的次数。

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 帧。
  • 多播或广播 MSDU 数据包或 MMPDU 帧,其目标 MAC 地址与 802.11 工作站的多播地址列表中的条目匹配。 有关多播地址列表的详细信息,请参阅 OID_DOT11_MULTICAST_LIST

ullMaxRXLifetimeExceededCount

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

ullFrameDuplicateCount

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

ullReceivedFragmentCount

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

ullPromiscuousReceivedFragmentCount

启用混杂数据包筛选器时,MSDU 数据包或 MMPDU 帧的 802.11 工作站收到的 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

Native 802.11 统计信息