DIF_POWERMESSAGEWAKE
DIF_POWERMESSAGEWAKE要求可讓安裝程式提供 Windows 在裝置屬性的電源管理屬性頁面上顯示的自訂文字。
傳送時
當使用者按一下功能表項目或索引標籤以顯示裝置的屬性時。
如果裝置的驅動程式支援電源管理,Windows 只會傳送此 DIF 要求。 否則,Windows 不會顯示裝置的任何電源屬性。
誰處理
類別共同安裝程式 |
可以處理 |
裝置共同安裝程式 |
可以處理 |
類別安裝程式 |
可以處理 |
安裝程式輸入
DeviceInfoSet
提供包含 裝置之裝置資訊集 的控制碼。
DeviceInfoData
提供 SP_DEVINFO_DATA 結構的指標,以識別裝置資訊集中的裝置。
裝置安裝參數
與DeviceInfoData相關聯的裝置安裝參數 (SP_DEVINSTALL_PARAMS) 。
類別安裝參數
SP_POWERMESSAGEWAKE_PARAMS結構與DeviceInfoData相關聯。
安裝程式輸出
類別安裝參數
安裝程式可以修改 SP_POWERMESSAGEWAKE_PARAMS ,以提供裝置電源屬性頁面的自訂文字。
安裝程式傳回值
共同安裝程式通常會傳回NO_ERROR、ERROR_DI_POSTPROCESSING_REQUIRED或 Win32 錯誤碼。
如果類別安裝程式成功提供電源屬性文字,則類別安裝程式會傳回NO_ERROR。 否則,類別安裝程式會傳回ERROR_DI_DO_DEFAULT或 Win32 錯誤碼。
預設 DIF 程式碼處理常式
無
安裝程式作業
DIF_POWERMESSAGEWAKE要求可讓安裝程式提供 Windows 在裝置電源屬性頁面上顯示的文字。
如果共同安裝程式提供電源屬性文字,則應該在其後置處理階段中執行此動作。 當覆寫安裝程式在共同安裝程式之前處理要求的任何電源屬性文字時,應該小心。
如需 DIF 程式碼的詳細資訊,請參閱 處理 DIF 程式碼。
規格需求
版本 |
Microsoft Windows 2000 和更新版本的 Windows 支援。 |
標頭 |
Setupapi.h (包括 Setupapi.h) |