共用方式為

在批註方塊通知內顯示自訂 UI 頁面

  • 發行項

 

如果 Native 802.11 IHV 擴充功能 DLL 呼叫 Dot11ExtSendUIRequest 來顯示自訂使用者介面 (UI) ，如果無線區域網路 (WLAN) 介面卡已連線到無線網路，作業系統將會透過可點選的方塊通知來顯示 UI。 在此情況下，自訂 UI 的要求會顯示為批註通知：

如需 Native 802.11 IHV 延伸模組 DLL 如何要求顯示自訂 UI 的詳細資訊，請參閱 要求顯示自訂 UI。

將自訂 UI 要求當做批註通知處理時，作業系統會執行下列動作。

  1. 呼叫 Native 802.11 IHV 延伸模組 DLL 的 Dot11ExtIhvIsUIRequestPending IHV Handler 函式，以判斷 UI 要求是否仍在擱置中。 作業系統會使用由 Native 802.11 IHV Extensions DLL 傳遞至 Dot11ExtSendUIRequest (GUID 全域唯一識別碼) 來指定 UI 要求。

  2. 如果 Dot11ExtIhvIsUIRequestPending 針對指定的 UI 要求傳回 TRUE ，作業系統會呼叫 Native 802.11 IHV UI Extensions DLL 的 IDot11ExtUI：：GetDot11ExtUIBalloonText 方法。 透過這個方法，DLL 會傳回字串緩衝區，其中包含要顯示在批註方塊通知內的當地語系化文字。

  3. 顯示包含當地語系化文字的批註通知。

  4. 如果使用者按一下方塊通知，作業系統將會啟動所要求 IWizardExtension COM 介面支援的自訂 UI。 呼叫 Dot11ExtSendUIRequest時，Native 802.11 IHV Extensions DLL 會指定原生 802.11 IHV UI 延伸模組 DLL 內 IWizardExtension 實作的類別識別碼 (CLSID) 。

    當作業系統呼叫 IWizardExtension：：AddPages 方法時，Native 802.11 IHV UI Extensions DLL 會傳回代表自訂 UI 頁面之 PROPSHEETPAGE 結構的控制碼陣列。

    如需 IWizardExtension COM 介面的詳細資訊，請參閱 IWizardExtension COM 介面。 如需 PROPSHEETPAGE 結構的詳細資訊，請參閱Microsoft Windows SDK中的檔。

  5. 透過 IWizardSite COM 介面巡覽原生 802.11 IHV UI 延伸模組 DLL 所指定的 UI 頁面。 如需此介面的詳細資訊，請參閱 IWizardSite COM 介面。

顯示自訂 UI 時，Native 802.11 IHV UI 延伸模組 DLL 可以透過 IPropertyBag COM 介面讀取或寫入內容特定資料。 如需此程式的詳細資訊，請參閱 存取設定檔和內容資料。 自訂 UI 的顯示完成之後，Native 802.11 IHV UI 延伸模組 DLL 可以藉由呼叫 WlanSendUIResponse ，將使用者輸入的回應資料傳回原生 802.11 IHV 擴充功能 DLL。 DLL 會傳入 UI 要求的 GUID，以及包含回應資料的緩衝區指標。

在 Native 802.11 IHV UI Extensions DLLcalls WlanSendUIResponse之後，作業系統會呼叫 Native 802.11 IHV 擴充 DLL 的 Dot11ExtIhvProcessUIResponse IHV 處理常式函式來轉送自訂 UI 的回應資料。

如需 WlanSendUIResponse API 的詳細資訊，請參閱 Windows SDK 中的檔。