OID_WDI_TASK_CONNECT (dot11wificxintf.h)

Важно!

Этот раздел является частью модели драйвера WiFiCx. WiFiCx — это модель драйвера Wi-Fi, выпущенная в Windows 11. Мы рекомендуем использовать WiFiCx, чтобы воспользоваться преимуществами новейших функций. Предыдущий Wi-Fi модель драйвера WDI находится в режиме обслуживания и будет получать только исправления с высоким приоритетом.

OID_WDI_TASK_CONNECT запрашивает подключение компонента IHV к точке доступа или к Wi-Fi Direct GO.

Объект	Возможность прерывания	Приоритет по умолчанию (политика драйвера узла)	Обычное время выполнения (в секундах)
Port	Да. За прерыванием должен следовать сброс dot11.	4	10

В рамках подключения компонент IHV должен синхронизироваться с BSS, выполнять проверку подлинности и связываться с ним. Узел предоставляет записи BSS, к которым может попытаться подключиться компонент IHV. После успешного подключения компонента IHV к одной из этих записей он должен завершить процесс подключения. Если не удается подключиться к какой-либо из записей BSS, он должен завершить процесс подключения с ошибкой.

Компоненту IHV не нужно выполнять сканирование для поиска потенциальных записей BSS. Он может использовать список, предоставленный узлом для подключения. Он может пытаться подключиться к каждому из них, один за другим. Узел сортирует сети по RSSI, но компонент IHV может использовать собственный порядок подключения. Если адаптер не указывает "Connect BSS Selection Override", он должен использовать только записи, предоставленные узлом для подключения. Узел может выпустить прерывание при неоплаченном подключении. При получении прерывания порт должен завершить попытки подключения и сообщить о завершении на узел.

Если адаптер указывает "Подключить BSS Selection Override", он может выполнять сканирование самостоятельно для поиска потенциальных записей BSS. Он может подключаться к любой записи BSS, которую находит, при условии, что она соответствует параметрам, настроенным узлом. Он должен оптимизировать этот выбор, чтобы убедиться, что он соответствует любым настроенным требованиям к качеству подключения. Это может включать в себя оптимизацию сканирования в роуминге, оптимизацию выбора AP, оптимизацию процесса сопоставления и минимизацию необходимого подтверждения безопасности. Если во время сканирования устройству требуются дополнительные параметры связи для найденной записи BSS (например, PMKID для роуминга), оно может отправить NDIS_STATUS_WDI_INDICATION_ASSOCIATION_PARAMETERS_REQUEST указание для получения параметров. Если они доступны, узел настраивает эти параметры с помощью OID_WDI_SET_ASSOCIATION_PARAMETERS.

Если подключение завершается сбоем или прерывается, порт не должен сбрасывать параметры, которые могли быть настроены за пределами команды connect. Он должен поддерживать узел, выполняющий второй вызов подключения на том же порту.

Состояние попытки подключения для каждой записи BSS должно быть сообщено портом в конце попытки связи. Сюда входят успешные попытки, а также любые неудачные попытки. В любой момент порт должен быть связан не более чем с одной точкой доступа или Wi-Fi Direct GO.

Пока подключение выполняется, порт должен поддерживать все подключения, установленные на других портах (например, Инфраструктура или Wi-Fi Direct). Однако для завершения подключения порт может уменьшить объем среднего доступа, предоставляемого другим портам. Во время подключения узел может отправлять запросы на отправку пакетов на другие порты.

Если алгоритм проверки подлинности, используемый для подключения, требует авторизации порта 802.1x для доступа к сети, узел авторизует порт после успешного завершения операции сопоставления.

Станция 802.11 использует кэш PMKID для предварительной проверки подлинности для доступа к точкам, в которых включен алгоритм проверки подлинности RSNA. Если станция 802.11 связывается или повторно связывается с BSSID, который имеет предоставленный PMKID, то станция 802.11 должна использовать данные PMKID в информационном элементе RSN (RSN IE) своего кадра Association или Reassociation.

Если порт объявляет поддержку режима FIPS узла в WIFI_STATION_CAPABILITIES, параметр HostFIPSModeEnabled может иметь значение 1 в параметрах подключения.

Если параметр HostFIPSModeEnabled имеет значение 1, применяются следующие правила.

• Порт должен соответствовать рекомендациям по отправке и получению кадров данных в разделе Отправка операций в режиме FIPS и Операции получения в режиме FIPS.
• Порт не должен объявлять поддержку протокола QoS в запросе на связь, отправляемом точке доступа, отличной от HT. Для подключений по протоколу HT требуется поддержка QoS.
• Порт не должен согласовывать TSpec и не должен выполнять агрегирование передачи MSDU.
• Порт должен гарантировать, что бит SPP A-MSDU (бит 10) возможностей RSN, передаваемых IE, равен нулю. В этом режиме поддерживается только PP A-MSDU.

Параметры подключения не должны иметь значение 1 для MFPEnabled и HostFIPSModeEnabled. Для защиты кадров управления (802.11w) требуется, чтобы порт зашифровывал или расшифровывал определенные кадры управления и действий, поэтому его нельзя включить для подключения в режиме FIPS узла. Кроме того, функции пробуждения по беспроводной локальной сети не применяются в режиме host-FIPS.

Параметры задачи

TLV	Разрешено несколько экземпляров TLV	Необязательно	Описание
WDI_TLV_CONNECT_PARAMETERS			Параметры подключения.
WDI_TLV_CONNECT_BSS_ENTRY	X		Предпочтительный список потенциальных записей BSS подключения. Порт должен пытаться подключиться к любой из этих записей BSS, пока список не будет исчерпан или подключение не будет успешно завершено. При необходимости порт может повторно выполнить повторную запись. Если адаптер задал бит переопределения выбора подключения BSS, он может выбрать BSS, которого нет в этом списке, если он следует за списком Разрешено/Запрещено.

Указание завершения задачи

NDIS_STATUS_WDI_INDICATION_CONNECT_COMPLETE

Незапрошенное указание

NDIS_STATUS_WDI_INDICATION_ASSOCIATION_RESULT

NDIS_STATUS_WDI_INDICATION_SAE_AUTH_PARAMS_NEEDED

Требования

Требование	Значение
Минимальная версия клиента	Windows 11
Минимальная версия сервера	Windows Server 2022
Заголовок	dot11wificxintf.h