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

Статья
03/01/2024

ВажноСобственный интерфейс беспроводной локальной сети 802.11 не рекомендуется использовать в Windows 10 и более поздних версиях. Вместо этого используйте WLAN Device Driver Interface (WDI). Дополнительные сведения о WDI см. в статье Модель универсального драйвера WLAN для Windows.

Структура DOT11_STATISTICS записывает статистические счетчики для интерфейса 802.11.

Синтаксис

typedef struct DOT11_STATISTICS {
  NDIS_OBJECT_HEADER         Header;
  ULONGLONG                  ullFourWayHandshakeFailures;
  ULONGLONG                  ullTKIPCounterMeasuresInvoked;
  ULONGLONG                  ullReserved;
  DOT11_MAC_FRAME_STATISTICS MacUcastCounters;
  DOT11_MAC_FRAME_STATISTICS MacMcastCounters;
  DOT11_PHY_FRAME_STATISTICS PhyCounters[1];
} DOT11_STATISTICS, *PDOT11_STATISTICS;

Члены

Header

Тип, редакция и размер структуры DOT11_STATISTICS. Этот элемент имеет формат структуры NDIS_OBJECT_HEADER .

Драйвер мини-порта должен задать для членов Header следующие значения:

Тип

Для этого элемента должно быть задано значение NDIS_OBJECT_TYPE_DEFAULT.

Редакция

Для этого элемента должно быть задано значение DOT11_STATISTICS_REVISION_1.

Размер

Для этого элемента должно быть задано значение sizeof(DOT11_STATISTICS).

Дополнительные сведения об этих членах см. в разделе NDIS_OBJECT_HEADER.

ullFourWayHandshakeFailures

Число четырехстороннего подтверждения, с которыми станция 802.11 столкнулась во время проверки подлинности Wi-Fi защищенного доступа (WPA) или проверки подлинности RSNA.

Если станция 802.11 не выполняет проверку подлинности WPA или RSNA, она должна задать для этого элемента значение DOT11_STATISTICS_UNKNOWN.

ullTKIPCounterMeasuresInvoked

Количество раз, когда станция 802.11 вызывала контрмеры после сбоя кода целостности сообщений (MIC).

Если станция 802.11 не выполняет контрмеры TKIP, она должна задать для этого элемента значение DOT11_STATISTICS_UNKNOWN.

ullReserved

Этот элемент зарезервирован для использования операционной системой. Драйвер мини-порта не должен выполнять запись в этот член.

MacUcastCounters

Счетчики уровня MAC на основе одноадресных пакетов, отправленных или полученных станцией 802.11. Структура данных для этого элемента — структура DOT11_MAC_FRAME_STATISTICS .

Примечание

Счетчики для полученных одноадресных пакетов должны увеличиваться только для этих пакетов с целевым MAC-адресом в заголовке MAC 802.11, который соответствует MAC-адресу станции 802.11.

MacMcastCounters

Счетчики уровня MAC на основе многоадресных или широковещательных пакетов, отправленных или полученных станцией 802.11. Структура данных для этого элемента — структура DOT11_MAC_FRAME_STATISTICS .

Примечание

Счетчики для полученных многоадресных или широковещательных пакетов должны увеличиваться только для этих пакетов с целевым MAC-адресом в заголовке MAC 802.11, который соответствует записи в списке адресов многоадресной рассылки станции 802.11. Дополнительные сведения о списке адресов многоадресной рассылки см. в разделе OID_DOT11_MULTICAST_LIST.

PhyCounters[1]

Массив счетчиков слоев PHY. Каждая запись в этом массиве имеет формат DOT11_PHY_FRAME_STATISTICS структура.

Драйвер мини-порта должен поддерживать запись в массиве PhyCounters для каждого поддерживаемого PHY. Если станция 802.11 поддерживает несколько объектов PHY одного типа, драйвер минипорта должен создать отдельные записи для каждого из них.

Записи в массиве PhyCounters должны находиться в том же порядке, что и список поддерживаемых PHY, возвращаемых драйвером при запросе OID_DOT11_SUPPORTED_PHY_TYPES.

Драйвер мини-порта должен безоговорочно установить все счетчики в структуре DOT11_STATISTICS равным нулю, включая счетчики уровня MAC и PHY, если происходит одно из следующих действий:

Вызывается функция MiniportInitializeEx драйвера.
Функция MiniportOidRequest драйвера вызывается с запросом на набор OID OID_DOT11_RESET_REQUEST независимо от типа операции сброса, указанной в запросе на набор.

Дополнительные сведения о статистике, собранной драйвером мини-порта native 802.11, см. в статье Статистика машинного кода 802.11.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Верхняя часть	windot11.h (включая Ndis.h)

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

OID_DOT11_STATISTICS

Поделиться через