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

Important

WiFiCx is the new Wi-Fi driver model released in Windows 11. Мы рекомендуем использовать WiFiCx для использования новейших функций. Модель драйвера WDI теперь находится в режиме обслуживания и получит только исправления с высоким приоритетом.

The DOT11_EXTSTA_ATTRIBUTES structure defines the physical and operating attributes of the miniport driver and 802.11 station when operating in Extensible Station (ExtSTA) mode. Дополнительные сведения об этом режиме работы см. в режиме эксплуатации расширяемой станции.

Syntax

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;

Members

Header

The type, revision, and size of the DOT11_EXTSTA_ATTRIBUTES structure. This member is formatted as an NDIS_OBJECT_HEADER structure.

The miniport driver must set the members of Header to the following values.

Type

This member must be set to NDIS_OBJECT_TYPE_DEFAULT.

Revision

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

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

These values determine how the operating system interprets the bSafeModeImplemented member.

Size

This member must be set to sizeof(DOT11_EXTSTA_ATTRIBUTES).

For more information about these members, see NDIS_OBJECT_HEADER.

uScanSSIDListSize

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

The SSID list that the 802.11 station uses for scanning is specified when OID_DOT11_SCAN_REQUEST is set.

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-адресов, исключенных из списка 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.

The following table lists the minimum and maximum key lengths, in bytes, for the various WEP cipher values defined through DOT11_CIPHER_ALGORITHM.

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

uPMKIDCacheSize

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

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

For more information about the PMKID cache, see OID_DOT11_PMKID_LIST.

uMaxNumPerSTADefaultKeyTables

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

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

bStrictlyOrderedServiceClassImplemented

A Boolean value that, if set to TRUE, specifies that the 802.11 station supports the IEEE 802.11 StrictlyOrdered service class for media access control (MAC) service data unit (MSDU) packet delivery.

Дополнительные сведения о классе служб 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

Функция безопасного режима поддерживает сочетание драйверов сетевого адаптера и мини-порта. The operating system interprets this member differently depending on the value of Header.Revision:

Редакция = DOT11_EXTSTA_ATTRIBUTES_REVISION_1

The operating system interprets the bSafeModeImplemented member as a Boolean value. If this value is TRUE, the NIC implements the 802.11 safe mode of operation. Otherwise, the value is FALSE.

Редакция = DOT11_EXTSTA_ATTRIBUTES_REVISION_2 или более поздней версии

The operating system interprets the bSafeModeImplemented member as a bit field with the following possible bit values set:

  • If the bit field is set to DOT11_EXTSTA_ATTRIBUTES_SAFEMODE_OID_SUPPORTED with no other bits set, the miniport driver implements the 802.11 safe mode of operation.
  • If the bit field is set to DOT11_EXTSTA_ATTRIBUTES_SAFEMODE_CERTIFIED, the NIC/miniport combination has received a validation certificate from the National Institute of Standards and Technology (NIST) under Federal Information Processing Standards (FIPS) Publication 140-2, Security Requirements for Cryptographic Modules.
Этот элемент используется вместе с OID_DOT11_SAFE_MODE_ENABLED.

uNumSupportedCountryOrRegionStrings

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

If the 802.11 station does not support the IEEE 802.11d-2001 standard, the miniport driver must set uNumSupportedCountryOrRegionStrings to zero.

pSupportedCountryOrRegionStrings

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

uInfraNumSupportedUcastAlgoPairs

Количество алгоритмов проверки подлинности и шифров, поддерживаемых станцией 802.11 для отправки и получения одноадресных пакетов при настройке для операции в сети базового набора служб инфраструктуры (BSS). The uInfraNumSupportedUcastAlgoPairs member must be the number of DOT11_AUTH_CIPHER_PAIR structures in the array referenced by the pInfraSupportedUcastAlgoPairs member.

pInfraSupportedUcastAlgoPairs

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

uInfraNumSupportedMcastAlgoPairs

Количество алгоритмов проверки подлинности и шифров, поддерживаемых станцией 802.11 для отправки и приема многоадресных и широковещательных пакетов при настройке для операций в сети базового набора служб инфраструктуры (BSS). The uInfraNumSupportedMcastAlgoPairs member must be the number of DOT11_AUTH_CIPHER_PAIR structures in the array referenced by the pInfraSupportedMcastAlgoPairs member.

pInfraSupportedMcastAlgoPairs

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

uAdhocNumSupportedUcastAlgoPairs

Количество алгоритмов проверки подлинности и шифров, поддерживаемых станцией 802.11 для отправки и получения одноадресных пакетов при настройке для операции в независимой сети BSS (IBSS). The uAdhocNumSupportedUcastAlgoPairs member must be the number of DOT11_AUTH_CIPHER_PAIR structures in the array referenced by the pAdhocSupportedUcastAlgoPairs member.

pAdhocSupportedUcastAlgoPairs

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

uAdhocNumSupportedMcastAlgoPairs

Количество алгоритмов проверки подлинности и шифров, поддерживаемых станцией 802.11 для отправки и получения многоадресных и широковещательных пакетов при настройке для операции в сети IBSS. The uAdhocNumSupportedMcastAlgoPairs member must be the number of DOT11_AUTH_CIPHER_PAIR structures in the array referenced by the pAdhocSupportedMcastAlgoPairs member.

pAdhocSupportedMcastAlgoPairs

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

bAutoPowerSaveMode

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

uMaxNetworkOffloadListSize

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

bMFPCapable

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

uInfraNumSupportedMcastMgmtAlgoPairs

The length of the array of authentication and cipher algorithm pairs pointed to in pInfraSupportedMcastMgmtAlgoPairs.

pInfraSupportedMcastMgmtAlgoPairs

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

bNeighborReportSupported

bAPChannelReportSupported

bActionFramesSupported

bANQPQueryOffloadSupported

bHESSIDConnectionSupported

Remarks

The NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES structure contains a member (pExtSTAAttributes) that specifies the address of a DOT11_EXTSTA_ATTRIBUTES structure. When the miniport driver calls NdisMSetMiniportAttributes, the driver sets the MiniportAttributes parameter to the address of a driver-allocated block of memory which contains an NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES structure along with the DOT11_EXTSTA_ATTRIBUTES structure.

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

Requirements

Requirement Value
Минимальный поддерживаемый клиент Доступно в windows 8 и более поздних версиях операционных систем Windows.
Header windot11.h (include Ndis.h)

See also

Режим работы расширяемой станции

OID_DOT11_DESIRED_BSSID_LIST

OID_DOT11_EXCLUDED_MAC_ADDRESS_LIST

OID_DOT11_PMKID_LIST

OID_DOT11_DESIRED_SSID_LIST

DOT11_COUNTRY_OR_REGION_STRING

OID_DOT11_SAFE_MODE_ENABLED

OID_DOT11_PRIVACY_EXEMPTION_LIST

NDIS_OBJECT_HEADER

OID_DOT11_CIPHER_KEY_MAPPING_KEY

DOT11_AUTH_CIPHER_PAIR

DOT11_CIPHER_ALGORITHM

ключи по умолчаниюPer-Station

NdisMSetMiniportAttributes

NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES

OID_DOT11_SCAN_REQUEST