OID_WDI_TASK_SCAN (dot11wificxintf.h)

Важный

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

OID_WDI_TASK_SCAN запрашивает опрос сетей BSS. Порт выполняет проверку в соответствии с требованиями спецификации IEEE 802.11.

Объект	Возможность прерывания	Приоритет по умолчанию (политика драйвера узла)	Обычное время выполнения (секунды)
Порт	Да. Порт должен находиться в состоянии очистки после прерывания.	6 (фоновая проверка) 5 (проверка, инициированная пользователем)	4

Сообщение о запуске задачи, содержащее WDI_TLV_STATUS, указывается после запуска проверки порта и готово к получению других команд.

После запуска сканирования при включении LiveUpdatesNeeded порт должен предоставлять добавочные обновления (используя незапрошенные признаки NDIS_STATUS_WDI_INDICATION_BSS_ENTRY_LIST) об обнаруженных записях BSS. Записи BSS, обнаруженные ранее, но не найдены портом в текущем сканировании, не должны сообщаться портом. По соображениям питания и производительности порт должен регулировать указания и отправлять обновления на узел только в том случае, если он обнаружил 3 или более, или когда он обнаружил менее 3 записей, но не сообщил их узлу более 500 миллисекунд. После завершения проверки, если адаптер не управляет записями BSS, ему не нужно запоминать обнаруженные записи BSS. После завершения операции сканирования порт должен отправить полное уведомление о задаче в операционную систему и остановить отправку отчетов записей BSS на узел. Команда сканирования используется для поиска устаревших (неWi-Fi прямых сетей), а порт не должен включать в запросы пробы Wi-Fi Direct IEs.

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

Узел отслеживает записи BSS с помощью BSSID. Если порт сообщает две записи BSS для одного и того же BSSID, узел перезаписывает друг с другом.

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

В указанных записях BSS порт может включать сведения о контексте устройства. Эти сведения контекста передаются на устройство, если порт запрашивается подключиться к этой записи BSS. Однако этот контекст может быть снят узлом автоматически, если запись BSS удаляется.

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

Адаптер не должен нарушать нормативные ограничения при выполнении сканирования.

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

TLV	Разрешено несколько экземпляров TLV	Необязательный	Описание
WDI_TLV_BSSID		X	BSSID сети для сканирования. Если это широковещательный MAC-адрес, станция сканирует все BSSID.
WDI_TLV_SSID	X	X	Список SSID, на который должен быть сканирован порт. В этом списке может быть несколько идентификаторов SSID, и один из них может быть подстановочным знаком. При активном сканировании на канале порт должен отправить запрос пробы для каждого SSID в списке. Если этот список пуст, порт должен сканировать все SSID.
WDI_TLV_BAND_CHANNEL	X	X	Список рекомендуемых каналов для сканирования. Адаптер может выполнять проверку подмножества или надмножества списка каналов, если он соответствует требованиям максимального времени сканирования. Если этот список пуст, порт должен сканировать все поддерживаемые каналы.
WDI_TLV_VENDOR_SPECIFIC_IE		X	Один или несколько IES, которые должны быть включены в запросы пробы, отправленные портом. Эти IEs не используются для пассивного сканирования.
WDI_TLV_SCAN_MODE			Параметры режима сканирования.
WDI_TLV_SCAN_DWELL_TIME			Параметры времени ожидания.
WDI_TLV_6_GHZ_BAND_CHANNEL		X	Список каналов, рекомендуемых для сканирования в диапазоне 6 ГГц. При указании адаптер может выполнять проверку подмножества или надмножества списка каналов, если он соответствует требованиям максимального времени сканирования.

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

NDIS_STATUS_WDI_INDICATION_SCAN_COMPLETE

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

NDIS_STATUS_WDI_INDICATION_BSS_ENTRY_LIST

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

Требования

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