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

структура 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)

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

DOT11_ENCAP_ENTRY

DOT11_ASSOC_STATUS

NdisMIndicateStatusEx

DOT11_AUTH_ALGORITHM

OID_DOT11_ACTIVE_PHY_LIST

DOT11_CIPHER_ALGORITHM

DOT11_MAC_ADDRESS

OID_DOT11_DESIRED_PHY_LIST

OID_DOT11_DESIRED_BSS_TYPE

NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION

NDIS_OBJECT_HEADER