DOT11EXTIHV_QUERY_UI_REQUEST回调函数 (wlanihv.h)

项目
02/27/2024

重要本机 802.11 无线 LAN 接口在 Windows 10 及更高版本中已弃用。请改用 WLAN 设备驱动程序接口 (WDI) 。有关 WDI 的详细信息，请参阅 WLAN 通用 Windows 驱动程序模型。

每当连接状态发生更改时，操作系统将调用 Dot11ExtIhvQueryUIRequest 函数。调用此函数时，IHV 扩展 DLL 将返回操作系统可用于 UI 请求的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

IHV 扩展 DLL 用于引用无线 LAN (WLAN) 适配器的句柄。此句柄值是通过之前对 Dot11ExtIhvInitAdapter IHV 处理程序函数的调用指定的。

[in] connectionPhase

当前连接阶段。此成员的数据类型是 DOT11EXT_IHV_CONNECTION_PHASE 枚举：

connection_phase_any

指定任何连接阶段。

connection_phase_initial_connection

指定 IHV 扩展 DLL 启动预关联操作之前的连接阶段。有关预关联操作的详细信息，请参阅预关联操作。

connection_phase_post_l3_connection

指定 IHV 扩展 DLL 完成关联后操作后的连接阶段。有关关联后操作的详细信息，请参阅关联后操作。

[out] ppIhvUIRequest

指向 DOT11EXT_IHV_UI_REQUEST 结构的指针的地址。 IHV 扩展 DLL 必须通过调用 Dot11ExtAllocateBuffer 为 DOT11EXT_IHV_UI_REQUEST 结构分配缓冲区。

返回值

如果调用成功，函数将返回ERROR_SUCCESS。否则，它将返回 Winerror.h 中定义的错误代码。

注解

调用 Dot11ExtIhvQueryUIRequest 时，IHV 扩展 DLL 必须分配并返回格式化为 DOT11EXT_IHV_UI_REQUEST 结构的缓冲区。在这种情况下，DLL 必须遵循以下准则：

IHV 扩展 DLL 必须调用 Dot11ExtAllocateBuffer 来分配缓冲区。 DLL 从 Dot11ExtIhvQueryUIRequest 返回后，操作系统负责调用 Dot11ExtFreeBuffer 以释放缓冲区。
IHV 扩展 DLL 为 UI 请求设置 DOT11EXT_IHV_UI_REQUEST 结构的格式，该结构适用于连接状态的更改。
例如，如果 connectionPhase 设置为 connection_phase_initial_connection，则 IHV 扩展 DLL 可以设置DOT11EXT_IHV_UI_REQUEST结构的成员，以引用通知用户连接操作开始的用户界面页面。

要求

要求	值
最低受支持的客户端	在 Windows Vista 和更高版本的 Windows 操作系统中可用。
目标平台	桌面
标头	wlanihv.h (包括 Wlanihv.h)