структура DOT11_PHY_FRAME_STATISTICS (windot11.h)
Важный
WiFiCx — это новая модель драйвера Wi-Fi, выпущенная в Windows 11. Мы рекомендуем использовать WiFiCx для использования новейших функций. Модель драйвера WDI теперь находится в режиме обслуживания и получит только исправления с высоким приоритетом.
Структура DOT11_PHY_FRAME_STATISTICS записывает статистические счетчики для физического слоя IEEE (PHY) станции 802.11.
Синтаксис
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
Количество пакетов MSDU и кадров MMPDU, которые слой IEEE PHY станции 802.11 успешно передал.
ullMulticastTransmittedFrameCount
Количество многоадресной рассылки или широковещательных пакетов MSDU и кадров MMPDU, которые уровень IEEE PHY станции 802.11 успешно передал.
ullFailedCount
Количество пакетов MSDU и кадров MMPDU, которые не удалось передать станции 802.11 после превышения ограничений повтора, определенных счетчиками 802.11 IEEE dot11ShortRetryLimit или dot11LongRetryLimit MIB. Дополнительные сведения об этих счетчиках MIB см. в OID_DOT11_SHORT_RETRY_LIMIT или OID_DOT11_LONG_RETRY_LIMIT.
ullRetryCount
Количество пакетов MSDU и кадров MMPDU, которые станция 802.11 успешно передавалась после одной или нескольких попыток.
ullMultipleRetryCount
Количество пакетов MSDU и кадров MMPDU, которые станция 802.11 успешно передавалась после нескольких попыток повторной передачи.
Для пакетов MSDU драйвер минипорта должен увеличить этот счетчик для каждого пакета, передаваемого успешно после одного или нескольких фрагментов MPDU, необходимых для повторной передачи.
ullMaxTXLifetimeExceededCount
Количество пакетов MSDU и кадров MMPDU, которые не удалось передать станции 802.11 из-за времени ожидания, определенного объектом MIB IEEE 802.11 dot11MaxTransmitMSDULife time. Дополнительные сведения об этом объекте MIB см. в разделе OID_DOT11_MAX_TRANSMIT_MSDU_LIFETIME.
ullTransmittedFragmentCount
Количество кадров MPDU, передаваемых и подтвержденных через полученный кадр 802.11 ACK.
ullRTSSuccessCount
Количество раз, когда станция 802.11 получила кадр Clear To Send (CTS) в ответ на кадр отправки (RTS).
ullRTSFailureCount
Количество раз, когда станция 802.11 не получила кадр CTS в ответ на кадр RTS.
ullACKFailureCount
Количество раз, когда ожидается станция 802.11 и не получила кадр подтверждения (ACK).
ullReceivedFrameCount
Общее количество пакетов MSDU и кадров MMPDU, которые станция 802.11 успешно получила.
Для пакетов MSDU драйвер минипорта должен увеличить этот счетчик для каждого пакета, фрагменты MPDU которых были получены и переданы проверки последовательности проверки кадров (FCS) и обнаружения воспроизведения. Минипорт-драйвер должен увеличить этот элемент независимо от того, является ли полученный пакет MSDU или фрагмент MPDU сбоем расшифровки шифра на уровне MAC.
Этот счетчик необязателен. Если сетевой адаптер не поддерживает этот счетчик, драйвер минипорта должен задать для этого элемента значение DOT11_STATISTICS_UNKNOWN.
ullMulticastReceivedFrameCount
Количество многоадресных или широковещательных пакетов MSDU и кадров MMPDU, которые станция 802.11 успешно получила.
Для пакетов MSDU драйвер минипорта должен увеличить этот счетчик для каждого пакета, фрагменты MPDU которого были получены и переданы проверки FCS и обнаружения воспроизведения. Минипорт-драйвер должен увеличить этот элемент независимо от того, является ли полученный пакет MSDU или фрагмент MPDU сбоем расшифровки шифра на уровне MAC.
Этот счетчик необязателен. Если сетевой адаптер не поддерживает этот счетчик, драйвер минипорта должен задать для этого элемента значение DOT11_STATISTICS_UNKNOWN.
ullPromiscuousReceivedFrameCount
Количество пакетов MSDU или кадров MMPDU, полученных станцией 802.11 при включенном фильтре пакетов. Дополнительные сведения о фильтрах пакетов см. в OID_GEN_CURRENT_PACKET_FILTER.
Если включен неуловимый фильтр пакетов, мини-драйвер должен увеличить этот счетчик только для полученных пакетов MSDU или кадров MMPDU, которые были бы отклонены, если фильтр не был включен. Драйвер не должен увеличивать этот счетчик для:
- Одноадресная рассылка пакетов MSDU или кадров MMPDU с целевым MAC-адресом, соответствующим MAC-адресу станции 802.11.
- Многоадресная рассылка или широковещательные пакеты MSDU или кадры MMPDU с целевым MAC-адресом, который соответствует записи в списке адресов многоадресной рассылки станции 802.11. Дополнительные сведения о списке адресов многоадресной рассылки см. в OID_DOT11_MULTICAST_LIST.
ullMaxRXLifetimeExceededCount
Число, если пакеты MSDU и кадры MMPDU, отклоненные станцией 802.11 из-за времени ожидания, определенного объектом IEEE 802.11 dot11MaxReceiveLifetime MIB. Дополнительные сведения об этом объекте MIB см. в разделе OID_DOT11_MAX_RECEIVE_LIFETIME.
ullFrameDuplicateCount
Количество повторяющихся кадров MPDU, полученных станцией 802.11. Станция 802.11 определяет повторяющиеся кадры с помощью поля управления последовательностью заголовка MAC 802.11.
ullReceivedFragmentCount
Количество кадров MPDU, полученных станцией 802.11 для пакетов MSDU или кадров MMPDU.
ullPromiscuousReceivedFragmentCount
Количество кадров MPDU, полученных станцией 802.11 для пакетов MSDU или кадров MMPDU при включенном фильтре пакетов. Дополнительные сведения о фильтрах пакетов см. в OID_GEN_CURRENT_PACKET_FILTER.
Если включен неразрешительный фильтр пакетов, мини-драйвер должен увеличить этот счетчик только для полученных кадров MPDU, которые были бы отклонены, если фильтр не был включен. Драйвер не должен увеличивать этот счетчик для:
- Кадры UNIcast MPDU с целевым MAC-адресом, который соответствует MAC-адресу станции 802.11.
- Многоадресная рассылка или широковещательные кадры MPDU с целевым MAC-адресом, который соответствует записи в списке адресов многоадресной рассылки станции 802.11. Дополнительные сведения о списке адресов многоадресной рассылки см. в OID_DOT11_MULTICAST_LIST.
ullFCSErrorCount
Количество кадров MPDU, полученных станцией 802.11 с ошибками FCS.
Замечания
Члены этой структуры используются для записи статистики уровня PHY для:
- Пакеты MSDU 802.11.
- Кадры MMPDU 802.11.
- Кадры MPDU 802.11. Счетчики кадров MPDU должны включать все фрагменты MPDU, отправленные для пакета MSDU или кадра MMPDU.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Windows Vista и более поздних версиях операционных систем Windows. |
| заголовка | windot11.h (include Ndis.h) |
См. также
статистика расширяемой станции PHY