структура DOT11_PHY_FRAME_STATISTICS (windot11.h)

ВажноСобственный интерфейс беспроводной локальной сети 802.11 не рекомендуется использовать в Windows 10 и более поздних версиях. Вместо этого используйте WLAN Device Driver Interface (WDI). Дополнительные сведения о WDI см. в статье Модель универсального драйвера WLAN для Windows.
 
Структура 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 не удалось передать после превышения пределов повтора, определенных счетчиками MIB 802.11 IEEE dot11ShortRetryLimit или dot11LongRetryLimit . Дополнительные сведения об этих счетчиках 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 не удалось передать из-за времени ожидания, определенного в объекте IEEE 802.11 dot11MaxTransmitMSDULifetime MIB. Дополнительные сведения об этом объекте MIB см. в разделе OID_DOT11_MAX_TRANSMIT_MSDU_LIFETIME.

ullTransmittedFragmentCount

Количество кадров MPDU, которые станция 802.11 передала и подтвердила через полученный кадр ACK 802.11.

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) и обнаружения воспроизведения. Драйвер мини-порта должен увеличивать этот элемент независимо от того, происходит ли сбой расшифровки шифра на уровне MAC для полученного пакета MSDU или фрагмента MPDU.

Этот счетчик является необязательным. Если сетевой адаптер не поддерживает этот счетчик, драйвер мини-порта должен задать для этого элемента значение DOT11_STATISTICS_UNKNOWN.

ullMulticastReceivedFrameCount

Количество многоадресных или широковещательных пакетов MSDU и кадров MMPDU, успешно полученных станцией 802.11.

Для пакетов MSDU драйвер мини-порта должен увеличить этот счетчик для каждого пакета, фрагменты MPDU которого были получены и прошли проверку и обнаружение воспроизведения FCS. Драйвер мини-порта должен увеличивать этот элемент независимо от того, происходит ли сбой расшифровки шифра на уровне MAC для полученного пакета MSDU или фрагмента MPDU.

Этот счетчик является необязательным. Если сетевой адаптер не поддерживает этот счетчик, драйвер мини-порта должен задать для этого элемента значение 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 из-за времени ожидания, определенного объектом MIB IEEE 802.11 dot1MaxReceiveLifetime . Дополнительные сведения об этом объекте 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, которые были бы отклонены, если бы фильтр не был включен. Драйвер не должен увеличивать этот счетчик для следующих случаев:

  • Одноадресные кадры 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 (включая Ndis.h)

См. также раздел

Статистика PHY расширяемой станции

OID_DOT11_STATISTICS

DOT11_STATISTICS

Собственная статистика 802.11