структура DOT11_EXTSTA_ATTRIBUTES (windot11.h)
Синтаксис
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), требования к безопасности для криптографических модулей.
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) |
См. также раздел
Режим работы расширяемой станции
OID_DOT11_EXCLUDED_MAC_ADDRESS_LIST DOT11_COUNTRY_OR_REGION_STRING OID_DOT11_PRIVACY_EXEMPTION_LIST OID_DOT11_CIPHER_KEY_MAPPING_KEYКлючи по умолчанию для каждой станции
NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES