функция обратного вызова DOT11EXTIHV_QUERY_UI_REQUEST (wlanihv.h)

Статья
08/08/2023

ВажноСобственный интерфейс беспроводной локальной сети 802.11 не рекомендуется использовать в Windows 10 и более поздних версиях. Вместо этого используйте интерфейс WLAN Device Driver Interface (WDI). Дополнительные сведения о WDI см. в статье Модель универсального драйвера WLAN для Windows.

Операционная система вызывает функцию Dot11ExtIhvQueryUIRequest при изменении состояния подключения. При вызове этой функции библиотека DLL расширений IHV возвращает структуру DOT11EXT_IHV_UI_REQUEST , которую операционная система может использовать для запроса пользовательского интерфейса.

Синтаксис

DOT11EXTIHV_QUERY_UI_REQUEST Dot11extihvQueryUiRequest;

DWORD Dot11extihvQueryUiRequest(
  [in, optional] HANDLE hIhvExtAdapter,
  [in]           DOT11EXT_IHV_CONNECTION_PHASE connectionPhase,
  [out]          PDOT11EXT_IHV_UI_REQUEST *ppIhvUIRequest
)
{...}

Параметры

[in, optional] hIhvExtAdapter

Дескриптор, используемый библиотекой DLL расширений IHV для ссылки на адаптер беспроводной локальной сети (WLAN). Это значение дескриптора было указано при предыдущем вызове функции IHV Handler Dot11ExtIhvInitAdapter .

[in] connectionPhase

Текущий этап подключения. Типом данных для этого элемента является перечисление DOT11EXT_IHV_CONNECTION_PHASE :

connection_phase_any

Указывает любой этап подключения.

connection_phase_initial_connection

Указывает этап подключения до того, как библиотека DLL расширений IHV инициирует операцию предварительной связи. Дополнительные сведения об операции предварительного связывания см. в разделе Операции предварительной ассоциации.

connection_phase_post_l3_connection

Указывает этап подключения после завершения dll-библиотекой расширений IHV операции после сопоставления. Дополнительные сведения об операции после ассоциации см. в разделе Операции после ассоциации.

[out] ppIhvUIRequest

Адрес указателя на структуру DOT11EXT_IHV_UI_REQUEST . Библиотека DLL расширений IHV должна выделить буфер для структуры DOT11EXT_IHV_UI_REQUEST путем вызова Dot11ExtAllocateBuffer.

Возвращаемое значение

Если вызов завершается успешно, функция возвращает ERROR_SUCCESS. В противном случае возвращается код ошибки, определенный в Winerror.h.

При вызове Dot11ExtIhvQueryUIRequest библиотека DLL расширений IHV должна выделить и вернуть буфер в формате DOT11EXT_IHV_UI_REQUEST структуры. В этом случае библиотека DLL должна следовать следующим рекомендациям:

Библиотека DLL расширений IHV должна вызвать Dot11ExtAllocateBuffer для выделения буфера. После возврата библиотеки DLL из Dot11ExtIhvQueryUIRequest операционная система отвечает за вызов Dot11ExtFreeBuffer для освобождения буфера.
Библиотека DLL расширений IHV форматирует структуру DOT11EXT_IHV_UI_REQUEST для запроса пользовательского интерфейса, соответствующего изменению состояния подключения.
Например, если параметр connectionPhase имеет значение connection_phase_initial_connection, библиотека DLL расширений IHV может задать элементы структуры DOT11EXT_IHV_UI_REQUEST для ссылки на страницу пользовательского интерфейса, уведомляющую пользователя о начале операции подключения.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Целевая платформа	Персональный компьютер
Верхняя часть	wlanihv.h (включая Wlanihv.h)