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

Статья
02/27/2024

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

Структура DOT11_EXTSTA_ATTRIBUTES определяет физические и рабочие атрибуты водителя мини-порта и станции 802.11 при работе в режиме ExtSTA. Дополнительные сведения об этом режиме работы см. в разделе Режим работы расширяемой станции.

Синтаксис

typedef struct DOT11_EXTSTA_ATTRIBUTES {
  NDIS_OBJECT_HEADER              Header;
  ULONG                           uScanSSIDListSize;
  ULONG                           uDesiredBSSIDListSize;
  ULONG                           uDesiredSSIDListSize;
  ULONG                           uExcludedMacAddressListSize;
  ULONG                           uPrivacyExemptionListSize;
  ULONG                           uKeyMappingTableSize;
  ULONG                           uDefaultKeyTableSize;
  ULONG                           uWEPKeyValueMaxLength;
  ULONG                           uPMKIDCacheSize;
  ULONG                           uMaxNumPerSTADefaultKeyTables;
  BOOLEAN                         bStrictlyOrderedServiceClassImplemented;
  UCHAR                           ucSupportedQoSProtocolFlags;
  BOOLEAN                         bSafeModeImplemented;
  ULONG                           uNumSupportedCountryOrRegionStrings;
  PDOT11_COUNTRY_OR_REGION_STRING pSupportedCountryOrRegionStrings;
  ULONG                           uInfraNumSupportedUcastAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pInfraSupportedUcastAlgoPairs;
  ULONG                           uInfraNumSupportedMcastAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pInfraSupportedMcastAlgoPairs;
  ULONG                           uAdhocNumSupportedUcastAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pAdhocSupportedUcastAlgoPairs;
  ULONG                           uAdhocNumSupportedMcastAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pAdhocSupportedMcastAlgoPairs;
  BOOLEAN                         bAutoPowerSaveMode;
  ULONG                           uMaxNetworkOffloadListSize;
  BOOLEAN                         bMFPCapable;
  ULONG                           uInfraNumSupportedMcastMgmtAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pInfraSupportedMcastMgmtAlgoPairs;
} DOT11_EXTSTA_ATTRIBUTES, *PDOT11_EXTSTA_ATTRIBUTES;

Члены

Header

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

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

Тип

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

Редакция

Этот элемент должен иметь одно из следующих значений в соответствии с операционной системой, в которую предназначен драйвер:

DOT11_EXTSTA_ATTRIBUTES_REVISION_1

Windows Vista

DOT11_EXTSTA_ATTRIBUTES_REVISION_2

Windows Vista с пакетом обновления 1 (SP1) или более поздними версиями операционных систем Windows

DOT11_EXTSTA_ATTRIBUTES_REVISION_3

Windows 8 или более поздних версий операционных систем Windows

Эти значения определяют, как операционная система интерпретирует элемент bSafeModeImplemented .

Размер

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

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

uScanSSIDListSize

Максимальное количество идентификаторов набора служб (SSID), поддерживаемых станцией 802.11 для операций сканирования. Станция 802.11 должна поддерживать список SSID не менее четырех записей.

При установке OID_DOT11_SCAN_REQUEST указывается список SSID, который используется станцией 802.11 для сканирования.

uDesiredBSSIDListSize

Максимальное количество записей в требуемом списке идентификаторов базового набора служб (BSSID), поддерживаемых станцией 802.11. Станция 802.11 должна поддерживать список BSSID по крайней мере с одной записью.

Дополнительные сведения о требуемом списке BSSID см. в разделе OID_DOT11_DESIRED_BSSID_LIST.

uDesiredSSIDListSize

Максимальное количество записей в требуемом списке SSID, поддерживаемом станцией 802.11. Станция 802.11 должна поддерживать требуемый список SSID по крайней мере с одной записью.

Дополнительные сведения о нужном списке SSID см. в разделе OID_DOT11_DESIRED_SSID_LIST.

uExcludedMacAddressListSize

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

Дополнительные сведения о нужном списке исключенных MAC-адресов см. в разделе OID_DOT11_EXCLUDED_MAC_ADDRESS_LIST.

uPrivacyExemptionListSize

Максимальное количество записей в списке исключений конфиденциальности, поддерживаемых станцией 802.11. Станция 802.11 должна поддерживать список исключений конфиденциальности по крайней мере с одной записью.

Дополнительные сведения о списке исключений конфиденциальности см. в разделе OID_DOT11_PRIVACY_EXEMPTION_LIST.

uKeyMappingTableSize

Максимальное число ключей сопоставления ключей шифра, поддерживаемых станцией 802.11. Рекомендуется, чтобы станция 802.11 поддерживала по крайней мере 32 ключа для сопоставления ключей.

Дополнительные сведения о ключах сопоставления ключей см. в разделе OID_DOT11_CIPHER_KEY_MAPPING_KEY.

uDefaultKeyTableSize

Максимальное количество ключей шифра, поддерживаемых станцией 802.11 для ключа по умолчанию и таблиц ключей по умолчанию для каждой станции.

Для стандартных алгоритмов шифрования 802.11 станция 802.11 должна поддерживать таблицу размером не менее четырех ключей шифра. Для алгоритмов шифрования, разработанных независимым поставщиком оборудования (IHV), размер таблицы может быть четыре или больше.

uWEPKeyValueMaxLength

Максимальная длина в байтах ключа шифра WEP, поддерживаемого станцией 802.11.

В следующей таблице перечислены минимальные и максимальные длины ключей (в байтах) для различных значений шифра WEP, определенных с помощью DOT11_CIPHER_ALGORITHM.

Шифр WEP	Минимальная длина ключа	Максимальная длина ключа
DOT11_CIPHER_ALGO_WEP40	5	5
DOT11_CIPHER_ALGO_WEP104	13	13
DOT11_CIPHER_ALGO_WEP	13	Любая длина, поддерживаемая станцией 802.11

uPMKIDCacheSize

Максимальное количество записей в попарном master кэше идентификаторов ключей (PMKID), поддерживаемом станцией 802.11.

Если станция 802.11 не поддерживает кэш PMKID, драйвер мини-порта должен установить для этого элемента значение 0. В противном случае станция 802.11 должна поддерживать размер кэша PMKID не менее трех записей.

Дополнительные сведения о кэше PMKID см. в разделе OID_DOT11_PMKID_LIST.

uMaxNumPerSTADefaultKeyTables

Максимальное количество таблиц ключей шифров по умолчанию для каждой станции, поддерживаемых станцией 802.11. Рекомендуется, чтобы станция 802.11 поддерживала по умолчанию не менее 32 таблиц ключей шифров на каждую станцию.

Дополнительные сведения о таблицах ключей шифров по умолчанию для каждой станции см. в разделе Ключи по умолчанию для каждой станции.

bStrictlyOrderedServiceClassImplemented

Логическое значение, которое, если задано значение TRUE, указывает, что станция 802.11 поддерживает класс служб IEEE 802.11 StrictlyOrdered для доставки пакетов msdu службы управления доступом к мультимедиа (MAC).

Дополнительные сведения о классе служб StrictlyOrdered см. в предложении 5.1.3 стандарта IEEE 802.11-2012.

ucSupportedQoSProtocolFlags

Набор флагов, указывающих протоколы качества обслуживания (QoS), которые реализует сетевой адаптер. Этот элемент является нулевым или побитовой комбинацией или следующих флагов:

DOT11_QOS_PROTOCOL_FLAG_WMM

Сетевой адаптер реализует протокол QoS WMM 802.11.

DOT11_QOS_PROTOCOL_FLAG_11E

Сетевой адаптер реализует протокол QoS 802.11e.

bSafeModeImplemented

Возможность поддержки безопасного режима для сочетания драйвера сетевого адаптера и мини-порта. Операционная система интерпретирует этот элемент по-разному в зависимости от значения Header.Revision:

Редакция = DOT11_EXTSTA_ATTRIBUTES_REVISION_1

Операционная система интерпретирует элемент bSafeModeImplemented как логическое значение. Если это значение равно TRUE, сетевой адаптер реализует безопасный режим работы 802.11. В противном случае значение равно FALSE.

Редакция = DOT11_EXTSTA_ATTRIBUTES_REVISION_2 или выше

Операционная система интерпретирует элемент bSafeModeImplemented как битовое поле со следующими возможными значениями битов:

Если для битового поля задано значение DOT11_EXTSTA_ATTRIBUTES_SAFEMODE_OID_SUPPORTED без других битов, драйвер miniport реализует безопасный режим работы 802.11.
Если для битового поля задано значение DOT11_EXTSTA_ATTRIBUTES_SAFEMODE_CERTIFIED, сочетание сетевой карты и минипорта получило проверочный сертификат от Национального института стандартов и технологий (NIST) в соответствии с публикацией 140-2 федеральных стандартов обработки информации (FIPS), требования к безопасности для криптографических модулей.

Этот элемент используется в сочетании с OID_DOT11_SAFE_MODE_ENABLED.

uNumSupportedCountryOrRegionStrings

Количество строк страны или региона, поддерживаемых станцией 802.11. Если станция 802.11 поддерживает несколько нормативных доменов, как указано в стандарте IEEE 802.11d-2001, каждая строка страны или региона определяет нормативный домен, поддерживаемый станцией 802.11.

Если станция 802.11 не поддерживает стандарт IEEE 802.11d-2001, драйвер miniport должен установить для uNumSupportedCountryOrRegionStrings значение 0.

pSupportedCountryOrRegionStrings

Указатель на массив строк страны или региона 802.11d, поддерживаемых станцией 802.11. Каждая запись в массиве отформатирована как DOT11_COUNTRY_OR_REGION_STRING структура.

uInfraNumSupportedUcastAlgoPairs

Количество алгоритмов проверки подлинности и шифра, поддерживаемых станцией 802.11 для отправки и получения одноадресных пакетов при настройке для работы в сети BSS инфраструктуры. Элемент uInfraNumSupportedUcastAlgoPairs должен быть количеством DOT11_AUTH_CIPHER_PAIR структур в массиве, на который ссылается элемент pInfraSupportedUcastAlgoPairs .

pInfraSupportedUcastAlgoPairs

Указатель на массив алгоритмов проверки подлинности и шифров, поддерживаемых станцией 802.11 для отправки и получения одноадресных пакетов в сети BSS инфраструктуры. Каждая запись в массиве отформатирована как DOT11_AUTH_CIPHER_PAIR структура.

uInfraNumSupportedMcastAlgoPairs

Количество алгоритмов проверки подлинности и шифров, поддерживаемых станцией 802.11 для отправки и получения многоадресных и широковещательных пакетов при настройке для работы в сети BSS инфраструктуры. Элемент uInfraNumSupportedMcastAlgoPairs должен быть количеством DOT11_AUTH_CIPHER_PAIR структур в массиве, на который ссылается элемент pInfraSupportedMcastAlgoPairs .

pInfraSupportedMcastAlgoPairs

Указатель на массив алгоритмов проверки подлинности и шифров, поддерживаемых станцией 802.11 для отправки и получения многоадресных и широковещательных пакетов в сети BSS инфраструктуры. Каждая запись в массиве отформатирована как DOT11_AUTH_CIPHER_PAIR структура.

uAdhocNumSupportedUcastAlgoPairs

Количество алгоритмов проверки подлинности и шифра, поддерживаемых станцией 802.11 для отправки и получения одноадресных пакетов при настройке для работы в независимой сети BSS (IBSS). Элемент uAdhocNumSupportedUcastAlgoPairs должен быть количеством DOT11_AUTH_CIPHER_PAIR структур в массиве, на который ссылается элемент pAdhocSupportedUcastAlgoPairs .

pAdhocSupportedUcastAlgoPairs

Указатель на массив алгоритмов проверки подлинности и шифров, поддерживаемых станцией 802.11 для отправки и получения одноадресных пакетов в сети IBSS. Каждая запись в массиве отформатирована как DOT11_AUTH_CIPHER_PAIR структура.

uAdhocNumSupportedMcastAlgoPairs

Количество алгоритмов проверки подлинности и шифра, поддерживаемых станцией 802.11 для отправки и получения многоадресных и широковещательных пакетов при настройке для работы в сети IBSS. Элемент uAdhocNumSupportedMcastAlgoPairs должен быть количеством DOT11_AUTH_CIPHER_PAIR структур в массиве, на который ссылается элемент pAdhocSupportedMcastAlgoPairs .

pAdhocSupportedMcastAlgoPairs

Указатель на массив алгоритмов проверки подлинности и шифра, поддерживаемых станцией 802.11 для отправки и получения многоадресных и широковещательных пакетов в сети IBSS. Каждая запись в массиве отформатирована как DOT11_AUTH_CIPHER_PAIR структура.

bAutoPowerSaveMode

Поддержка сочетания драйвера сетевого адаптера и мини-порта для автономного управления питанием, включая обнаружение и согласование соответствующих Wi-Fi режиме экономии энергии (PSM) между устройством и точкой доступа Wi-Fi. Драйверы, совместимые с NDIS 6.30 Wi-Fi miniport, должны установить для этого элемента значение TRUE.

uMaxNetworkOffloadListSize

Максимальное количество сетей, которые может разгрузить драйвер минипорта, если он может поддерживать возможность разгрузки списка сетей.

bMFPCapable

Возможность комбинировать драйвер сетевой карты и минипорта для поддержки защиты кадров управления между устройством и точкой доступа Wi-Fi, как указано в спецификации 802.11w-2009. Задайте значение TRUE, если поддерживается. В противном случае этому элементу следует присвоить значение FALSE.

uInfraNumSupportedMcastMgmtAlgoPairs

Длина массива пар алгоритмов проверки подлинности и шифра, на которые указывает pInfraSupportedMcastMgmtAlgoPairs.

pInfraSupportedMcastMgmtAlgoPairs

Указатель на массив пары алгоритмов проверки подлинности и шифра, которые устройство поддерживает для MFP в режиме infra. Рекомендуемый шифр для Windows 8 — BIP с проверкой подлинности WPA или WPA2. Каждая запись в массиве отформатирована как DOT11_AUTH_CIPHER_PAIR структура.

bNeighborReportSupported

bAPChannelReportSupported

bActionFramesSupported

bANQPQueryOffloadSupported

bHESSIDConnectionSupported

The NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES структура содержит элемент (pExtSTAAttributes), указывающий адрес структуры DOT11_EXTSTA_ATTRIBUTES. Когда драйвер мини-порта вызывает NdisMSetMiniportAttributes, драйвер задает для параметра MiniportAttributes адрес выделенного драйвером блока памяти, который содержит структуру NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES вместе со структурой DOT11_EXTSTA_ATTRIBUTES.

Обязательное применение защиты кадров управления (MFPR) на Windows 8 не поддерживается. Поэтому драйверы miniport никогда не должны задавать этот бит в возможностях RSN IE во время запроса на сопоставление. Для политики точка доступа может объявлять MFPR, что позволит связать STA с поддержкой MFP. Точки доступа, не поддерживающие возможность MFP, не будут сопоставлены. Если MFPR задается точкой доступа, а STA не поддерживает MFP, Windows 8 будет рассматривать сеть как несовпадение возможностей и не отправлять запрос на связь в мини-порт.

Требования

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