windot11.h) (DOT11_PHY_FRAME_STATISTICS 结构
语法
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) |