OID_WDI_TASK_START_AP (dot11wificxintf.h)

Важный

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

OID_WDI_TASK_START_AP запрашивает, что компонент IHV настраивает порт для запуска Wi-Fi владельца прямой группы на указанном порту.

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

Во время инициализации драйвер задает возможность GO на диапазоне 5GГц в WIFI_WIFIDIRECT_CAPABILITIES, чтобы указать, может ли он запустить точку доступа на диапазоне 5 ГГц.

Если задана поддержка диапазона go на 5 ГГц, адаптер должен запустить AP на канале "Объявленная операционная система" и при сбое, он должен попробовать список, указанный в параметре списка каналов диапазона AP. Операционная система предоставит драйверу указание о том, будет ли этот AP предоставлять подключение к Интернету, задав флаг DOT11_WFD_GROUP_CAPABILITY_CROSS_CONNECTION_SUPPORTED в WDI_TLV_P2P_GROUP_OWNER_CAPABILITY.

Если указан MustUseSpecifiedChannel в WDI_TLV_START_AP_PARAMETERS, ТО AP может вернуть одну из следующих ошибок, если не удается запустить AP на указанных группах или каналах:

  • NDIS_STATUS_DOT11_AP_CHANNEL_CURRENTLY_NOT_AVAILABLE: не удается запустить AP на указанных каналах прямо сейчас. Повторите попытку в указанных каналах позже.

  • NDIS_STATUS_DOT11_AP_BAND_CURRENTLY_NOT_AVAILABLE: не удается запустить AP на указанных полосах прямо сейчас. Повторите попытку в указанных диапазонах позже.

  • NDIS_STATUS_DOT11_AP_CHANNEL_NOT_ALLOWED: не удается запустить AP на указанных каналах из-за нормативных причин.

  • NDIS_STATUS_DOT11_AP_BAND_NOT_ALLOWED: не удается запустить AP в указанных диапазонах из-за нормативных причин.

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

TLV Разрешено несколько экземпляров TLV Необязательный Описание
WDI_TLV_SSID SSID, используемый AP.
WDI_TLV_START_AP_PARAMETERS Дополнительные параметры для этой задачи.
WDI_TLV_AUTH_ALGO_LIST Список алгоритмов проверки подлинности, которые может использовать подключение.
WDI_TLV_MULTICAST_CIPHER_ALGO_LIST Список алгоритмов многоадресной рассылки, которые могут использовать подключение.
WDI_TLV_UNICAST_CIPHER_ALGO_LIST Список алгоритмов многоадресной рассылки, которые могут использовать подключение.
WDI_TLV_P2P_CHANNEL_NUMBER X Если задано, это определяет операционный канал, определенный в формировании группы. Это может быть указано только в том случае, если режим работы Wi-Fi Direct GO.
WDI_TLV_AP_BAND_CHANNEL X X Необязательный список полос и каналов для запуска точки доступа. Если для MustUseSpecifiedChannels задано значение 1, то api можно запустить только из этого списка. Если этот список не задан, этот список должен быть рекомендацией по каналам, из которые может выбрать встроенное ПО, и он может выбрать другой канал, если невозможно запустить AP на любом из указанных каналов.

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

NDIS_STATUS_WDI_INDICATION_START_AP_COMPLETE

Требования

Требование Ценность
Минимальный поддерживаемый клиент Windows 11
Минимальный поддерживаемый сервер Windows Server 2022
Заголовок dot11wificxintf.h