共用方式為


DOT11EXTIHV_QUERY_UI_REQUEST回呼函式 (wlanihv.h)

重要 Windows 10 和更新版本中已淘汰 Native 802.11 無線 LAN 介面。 請改用 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 來配置緩衝區。 從 Dot11ExtIhvQueryUIRequest傳回 DLL 之後,作系統會負責呼叫 Dot11ExtFreeBuffer 釋放緩衝區。
  • IHV 延伸模組 DLL 會將適用於連線狀態變更的 UI 要求 DOT11EXT_IHV_UI_REQUEST 結構格式化。

    例如,如果 connectionPhase 設定為 connection_phase_initial_connection,IHV Extensions DLL 可以設定 DOT11EXT_IHV_UI_REQUEST 結構的成員,以參考使用者介面頁面,通知用戶連線作業的開始。

要求

要求 價值
最低支援的用戶端 可在 Windows Vista 和更新版本的 Windows作系統中使用。
目標平臺 桌面
標頭 wlanihv.h (包括 Wlanihv.h)

另請參閱

Dot11ExtAllocateBuffer

DOT11EXT_IHV_UI_REQUEST

Dot11ExtIhvInitAdapter

Dot11ExtFreeBuffer