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 要求を使用すると、インストーラーはデバイスの電源プロパティ ページに表示されるテキストを提供できます。
共同インストーラーが電源プロパティ テキストを提供する場合は、後処理フェーズで行う必要があります。 共同インストーラーは、共同インストーラーの前に要求を処理したインストーラーによって提供される 電源プロパティ テキストを上書きするときは注意する必要があります。
DIF コードの詳細については、「DIF コードの処理」を参照してください。
要件
バージョン |
Microsoft Windows 2000 以降のバージョンの Windows でサポートされています。 |
ヘッダー |
Setupapi.h (Setupapi.h を含む) |