共用方式為


DOT11EXTIHV_QUERY_UI_REQUEST回呼函式 (wlanihv.h)

重要原生 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)

另請參閱

Dot11ExtAllocateBuffer

DOT11EXT_IHV_UI_REQUEST

Dot11ExtIhvInitAdapter

Dot11ExtFreeBuffer