структура DOT11_ASSOCIATION_COMPLETION_PARAMETERS (windot11.h)
Важно!
Собственный интерфейс беспроводной локальной сети 802.11 не рекомендуется использовать в Windows 10 и более поздних версиях. Вместо этого используйте интерфейс WLAN Device Driver Interface (WDI). Дополнительные сведения о WDI см. в статье Модель универсального драйвера WLAN для Windows.
Структура DOT11_ASSOCIATION_COMPLETION_PARAMETERS указывает результаты операции связи, выполняемой станцией 802.11 с точкой доступа (AP) или одноранговой станцией. Драйвер минипорта Native 802.11 включает структуру DOT11_ASSOCIATION_COMPLETION_PARAMETERS, когда драйвер минипорта создает NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION индикатор состояния.
Синтаксис
typedef struct DOT11_ASSOCIATION_COMPLETION_PARAMETERS {
NDIS_OBJECT_HEADER Header;
DOT11_MAC_ADDRESS MacAddr;
DOT11_ASSOC_STATUS uStatus;
BOOLEAN bReAssocReq;
BOOLEAN bReAssocResp;
ULONG uAssocReqOffset;
ULONG uAssocReqSize;
ULONG uAssocRespOffset;
ULONG uAssocRespSize;
ULONG uBeaconOffset;
ULONG uBeaconSize;
ULONG uIHVDataOffset;
ULONG uIHVDataSize;
DOT11_AUTH_ALGORITHM AuthAlgo;
DOT11_CIPHER_ALGORITHM UnicastCipher;
DOT11_CIPHER_ALGORITHM MulticastCipher;
ULONG uActivePhyListOffset;
ULONG uActivePhyListSize;
BOOLEAN bFourAddressSupported;
BOOLEAN bPortAuthorized;
UCHAR ucActiveQoSProtocol;
DOT11_DS_INFO DSInfo;
ULONG uEncapTableOffset;
ULONG uEncapTableSize;
DOT11_CIPHER_ALGORITHM MulticastMgmtCipher;
ULONG uAssocComebackTime;
} DOT11_ASSOCIATION_COMPLETION_PARAMETERS, *PDOT11_ASSOCIATION_COMPLETION_PARAMETERS;
Члены
Header
Тип, редакция и размер структуры DOT11_ASSOCIATION_COMPLETION_PARAMETERS. Этот элемент отформатирован как структура NDIS_OBJECT_HEADER .
Драйвер мини-порта должен задать для членов Header следующие значения:
Тип
Для этого элемента необходимо задать значение NDIS_OBJECT_TYPE_DEFAULT.
Редакция
Для этого элемента необходимо задать значение DOT11_ASSOCIATION_COMPLETION_PARAMETERS_REVISION_1.
Размер
Для этого элемента должно быть задано значение sizeof(DOT11_ASSOCIATION_COMPLETION_PARAMETERS).
Дополнительные сведения об этих элементах см. в разделе NDIS_OBJECT_HEADER.
MacAddr
Mac-адрес точки доступа (AP) (для сетей инфраструктуры BSS) или одноранговой станции (для независимых сетей BSS), к которым пыталась подключиться станция 802.11.
uStatus
Состояние завершения операции связи, указанное в значении, определенном для DOT11_ASSOC_STATUS.
bReAssocReq
Логическое значение, указывающее, отправляет ли станция 802.11 связь 802.11 или кадр повторной связи в AP. Если задано значение TRUE, то станция 802.11 отправляет кадр запроса повторной связи 801.11 в AP. Если значение РАВНО FALSE, то станция 802.11 отправила кадр запроса связи 802.11 в AP.
Значение TRUE для элемента bReAssocReq допустимо только в том случае, если для объекта MIB dot11DesiredBSSType задано значение dot11_BSS_type_infrastructure.
bReAssocResp
Логическое значение, указывающее, получила ли станция 802.11 связь 802.11 или кадр повторной связи от AP. Если задано значение TRUE, то станция 802.11 получила кадр ответа на повторное связывание 802.11 от AP. При значении FALSE станция 802.11 получила кадр ответа связи 802.11 от AP.
Значение TRUE для элемента bReAssocResp допустимо только в том случае, если для объекта MIB dot11DesiredBSSType задано значение dot11_BSS_type_infrastructure.
uAssocReqOffset
Смещение кадра запроса, используемого в операции сопоставления. Фрейм не содержит заголовок MAC 802.11.
Это смещение относительно начала буфера, содержащего структуру DOT11_ASSOCIATION_COMPLETION_PARAMETERS.
Кадр запроса на связь, возвращаемый драйвером мини-порта, зависит от настройки объекта MIB IEEE 802.11 dot1DesiredBSSType :
- Если для объекта MIB dot11DesiredBSSType задано значение dot11_BSS_type_infrastructure, фреймом является кадр запроса связи 802.11 (если bReAssocReq имеет значение FALSE) или кадр запроса повторного связывания (если bReAssocReq имеет значение TRUE), который был отправлен в AP. Драйвер мини-порта должен вернуть кадр запроса пробы 802.11, который либо отправляется инициатором сопоставления, либо создается драйвером на основе сведений, которыми обменивался во время операции сопоставления.
- Если для объекта MIB dot11DesiredBSSType задано значение dot11_BSS_type_independent, драйвер мини-порта должен задать для элемента uAssocReqOffset значение 0.
Драйвер мини-порта должен задать для элементов uAssocReqOffset и uAssocReqSize значение 0, если ему не удалось отправить кадр запроса во время операции сопоставления. Например, если ap failed the ap fail the 802.11 Authentication frame that was sent by the 802.11 station, the miniport driver must set uAssocReqOffset and uAssocReqSize to zero.
uAssocReqSize
Длина кадра запроса, используемого в операции сопоставления. Длина кадра не включает заголовок MAC 802.11.
Если для объекта MIB dot11DesiredBSSType задано значение dot11_BSS_type_independent, драйвер мини-порта должен задать для элемента uAssocReqSize значение 0.
uAssocRespOffset
Смещение кадра ответа, используемого в операции сопоставления. Фрейм не содержит заголовок MAC 802.11.
Это смещение относится к началу буфера, который содержит структуру DOT11_ASSOCIATION_COMPLETION_PARAMETERS.
Кадр ответа связи, возвращаемый драйвером miniport, зависит от настройки объекта MIB IEEE 802.11 dot1DesiredBSSType :
Если для объекта MIB dot11DesiredBSSType задано значение dot11_BSS_type_infrastructure, кадром является кадр ответа ассоциации 802.11 (если bReAssocReq имеет значение TRUE) или кадр ответа на повторное связывание (если bReAssocReq имеет значение FALSE), полученный от AP. Драйвер мини-порта должен вернуть кадр отклика пробы 802.11, который либо отправляется инициатору ассоциации, либо создается драйвером на основе информации, передаваемой во время операции сопоставления.
Если для объекта MIB dot11DesiredBSSType задано значение dot11_BSS_type_independent, драйвер мини-порта должен задать для элемента uAssocRespOffset значение 0.
Драйвер мини-порта должен задать для членов uAssocRespOffset и uAssocRespSize значение 0, если он не получил кадр ответа во время операции сопоставления.
uAssocRespSize
Длина кадра ответа, используемого в операции сопоставления. Длина кадра не включает заголовок MAC 802.11.
Если объект MIB dot11DesiredBSSType имеет значение dot11_BSS_type_independent, драйвер мини-порта должен задать для элемента uAssocRespSize значение 0.
uBeaconOffset
Смещение последнего полученного кадра маяка или отклика пробы 802.11. Драйвер мини-порта должен исключить заголовок MAC 802.11 для этих кадров при указании состояния NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION .
Это смещение относится к началу буфера, который содержит структуру DOT11_ASSOCIATION_COMPLETION_PARAMETERS.
Примечание
Если алгоритм проверки подлинности, используемый для связи, был Wi-Fi защищенного доступа (WPA) или IEEE 802.11i Robust Security Network Association (RSNA), драйвер мини-порта должен всегда возвращать последний полученный кадр маяка 802.11 и не должен устанавливать для членов uBeaconOffset и uBeaconSize значение 0.
uBeaconSize
Длина последнего полученного кадра маяка 802.11. Длина кадра не включает заголовок MAC 802.11.
uIHVDataOffset
Смещение блока данных в закрытом формате, определяемом IHV. IHV может использовать этот блок данных для любых целей, связанных с указанием состояния NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION .
Это смещение относится к началу буфера, который содержит структуру DOT11_ASSOCIATION_COMPLETION_PARAMETERS.
Если драйвер мини-порта не возвращает данные IHV в индикаторе состояния NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION , он должен задать для параметра uIHVDataOffset значение 0.
uIHVDataSize
Длина блока данных, используемого IHV для указания состояния NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION . Если драйвер мини-порта не возвращает данные IHV в этом указании, он должен задать для uIHVDataSize значение 0.
AuthAlgo
Алгоритм проверки подлинности, разрешенный станцией 802.11 с ap или одноранговой станцией во время операции сопоставления. Дополнительные сведения о типе данных для элемента AuthAlgo см. в разделе DOT11_AUTH_ALGORITHM.
Драйвер мини-порта должен задать для этого элемента нулевое значение, если для uStatus не задано значение DOT11_ASSOCIATION_STATUS_SUCCESS.
UnicastCipher
Алгоритм одноадресного шифра, который станция 802.11 разрешала с ap или одноранговой станцией во время операции сопоставления. Дополнительные сведения о типе данных для элемента UnicastCipher см. в разделе DOT11_CIPHER_ALGORITHM.
Драйвер мини-порта должен задать для этого элемента нулевое значение, если для uStatus не задано значение DOT11_ASSOCIATION_STATUS_SUCCESS.
MulticastCipher
Алгоритм многоадресного шифра, который станция 802.11 разрешала с ap или одноранговой станцией во время операции сопоставления. Дополнительные сведения о типе данных для элемента MulticastCipher см. в разделе DOT11_CIPHER_ALGORITHM
Драйвер мини-порта должен задать для этого элемента нулевое значение, если для uStatus не задано значение DOT11_ASSOCIATION_STATUS_SUCCESS.
uActivePhyListOffset
Смещение списка идентификаторов PHY, которые станция 802.11 использует для отправки или получения пакетов в сетевом подключении BSS.
Объект MIB extensible Station (ExtSTA) msDot11ActivePhyList также ссылается на активный список PHY.
Дополнительные сведения об этом объекте MIB см. в разделе OID_DOT11_ACTIVE_PHY_LIST.
Записи в активном списке PHY могут иметь одно из следующих значений:
- Идентификатор PHY, указанный объектом MIB ExtSTA msDot11DesiredPhyList . Дополнительные сведения об этом объекте MIB см. в разделе OID_DOT11_DESIRED_PHY_LIST.
- DOT11_PHY_ID_ANY. Драйвер мини-порта может задать для записи это значение, если объект msDot11ActivePhyList MIB задает все идентификаторы PHY, указанные объектом MIB msDot11DesiredPhyList . Запись со значением DOT11_PHY_ID_ANY должна быть единственной записью в активном списке PHY.
Смещение активного списка PHY относительно начала буфера, содержащего структуру DOT11_ASSOCIATION_COMPLETION_PARAMETERS.
Драйвер мини-порта должен задать для элементов uActivePhyListOffset и uActivePhyListSize нулевое значение, если для uStatus не задано значение DOT11_ASSOCIATION_STATUS_SUCCESS.
uActivePhyListSize
Длина активного списка PHY. Элемент uActivePhyListSize должен быть кратным sizeof(ULONG).
bFourAddressSupported
Логическое значение, если задано значение TRUE, указывает, что станция 802.11 связана с AP, поддерживающей службы системы распределения (DS) для моста уровня ISO 2 на любой станции в сети BSS, включая мобильные станции и точки доступа. Определение этой поддержки зависит от реализации IHV.
Драйвер мини-порта должен задать для элемента bFourAddressSupportedзначение FALSE , если выполняется одно из следующих действий:
- Объект IEEE 802.11 dot1DesiredBSSType MIB имеет значение dot11_BSS_type_independent.
- Станция 802.11 не связана с AP, поддерживающей службы DS, или не может определить, поддерживает ли она службы DS.
- Для элемента uStatus не задано значение DOT11_ASSOCIATION_STATUS_SUCCESS.
bPortAuthorized
Логическое значение, если задано значение TRUE, указывает, что станция 802.11 успешно выполнила авторизацию порта во время операции сопоставления. Авторизация портов может основываться либо на стандартах IEEE 802.1X/802.11i, либо на собственном алгоритме, разработанном IHV.
Драйвер мини-порта должен присвоить параметру bPortAuthorizedзначение FALSE , если выполняется одно из следующих действий:
- Станция 802.11 не выполняет авторизацию порта.
- Для элемента uStatus не задано значение DOT11_ASSOCIATION_STATUS_SUCCESS.
Дополнительные сведения об авторизации портов см. в разделе Доступ к сети на основе портов.
ucActiveQoSProtocol
Флаг, указывающий протокол качества обслуживания (QoS), который в настоящее время активен для этой связи. Этот элемент равен нулю (указывает, что протокол QoS не активен) или один из следующих флагов:
DOT11_QOS_PROTOCOL_FLAG_WMM
Сетевой адаптер использует протокол QoS WMM 802.11.
DOT11_QOS_PROTOCOL_FLAG_11E
Сетевой адаптер использует протокол QoS 802.11e.
DSInfo
Значение DOT11_DS_INFO, указывающее, подключена ли станция 802.11 к той же ds из предыдущей операции сопоставления.
Элемент DSInfo форматируется как перечисление DOT11_DS_INFO, которое задает следующие значения:
DOT11_DS_CHANGED
После операции связи станция 802.11 подключена к новой ds.
DOT11_DS_UNCHANGED
Станция 802.11 подключена к той же ds из операции сопоставления.
DOT11_DS_UNKNOWN
Драйвер мини-порта не может определить, изменился ли ds после операции сопоставления.
Примечание
Драйвер мини-порта должен задать для DSInfoзначение DOT11_DS_UNKNOWN , если объекту MIB dot11DesiredBSSType присвоено значение dot11_BSS_type_independent.
uEncapTableOffset
Смещение списка инкапсуляций IEEE EtherType для связи BSS.
Это смещение относительно начала буфера, который содержит структуру DOT11_ASSOCIATION_COMPLETION_PARAMETERS. Значение uEncapTableOffset должно быть выровнено по 4-байтовой границе.
Драйвер мини-порта форматирует каждую запись в этом списке как DOT11_ENCAP_ENTRY структуру.
Дополнительные сведения о списке инкапсуляции EtherType см. в разделе Инкапсуляция полезных данных 802.11.
uEncapTableSize
Длина списка инкапсуляции EtherType.
MulticastMgmtCipher
Алгоритм многоадресного шифрования, выбранный сетевым адаптером для связи для защиты кадров управления (MFP). Если MFP согласовано, этот элемент должен быть DOT11_CIPHER_ALGO_BIP. Если MFP не согласован, это поле должно быть DOT11_CIPHER_ALGO_NONE.
uAssocComebackTime
Если связь (повторно) завершается сбоем с кодом 30 причины 802.11 ("Запрос связи временно отклонен, повторите попытку позже"). Этот элемент указывает значение времени возврата связи, запрошенного точкой доступа (AP). Код причины отмены связи 802.11 присутствует в наименьших 16 битах uStatus при ответе на запрос на связь.
Служба автоматического подключения Windows добавит ap в список заблокированных и не будет пытаться повторно подключиться по крайней мере в течение указанного времени возврата. Сетевой адаптер будет вести себя как обычная неудачная проверка подлинности, пока не будет запущена следующая последовательность подключения. После истечения указанного времени ожидания (возврата) и остановки процесса подключения Windows может либо найти лучшее альтернативное подключение, либо вернуться к этому подключению. Это значение, заданное в этом элементе, должно использовать единицы времени, определенные в спецификации 802.11. Например, TU.
Комментарии
Драйвер мини-порта должен задать элементы uEncapTableOffset и uEncapTableSize равными нулю, если выполняется любое из следующих значений:
- Сопоставление BSS не требует внесения изменений в список инкапсуляции EtherType по умолчанию операционной системы.
- Для элемента uStatus не задано значение DOT11_ASSOCIATION_STATUS_SUCCESS.
- Для объекта MIB (ExtSTA) dot11DesiredBSSType задано значение dot11_BSS_type_independent.
Дополнительные сведения об объекте MIB IEEE 802.11 dot1DesiredBSSType см. в разделе OID_DOT11_DESIRED_BSS_TYPE.
Дополнительные сведения об операции сопоставления см. в разделе Операции сопоставления.
Защита кадров управления согласовывается, когда точка доступа (AP) и STA устанавливают для поля MFPC значение 1 в соответствующих идентификаторах RSN во время процедуры (re)ассоциации (т. е. Маяк или ответ пробы для AP и (повторно)запрос на связь для STA), а обе стороны подтверждают бит поддержки защиты кадра управления значение 1 в 4-way Handshake (Сообщения M2 и M3 802.11i 4-way handshake).
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Windows 8 и более поздних версиях операционных систем Windows. |
| Верхняя часть | windot11.h (включая Ndis.h) |
См. также раздел
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по