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 Handler 函式來指定。

[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)