DIF_TROUBLESHOOTER
DIF_TROUBLESHOOTER 要求を使用すると、インストーラーはデバイスのトラブルシューティング ツールを起動したり、Windows を起動するための CHM および HTM トラブルシューティング ツール ファイルを返したりすることができます。
メモ この DIF コードは、Windows Server 2003、Windows XP、および Microsoft Windows 2000 でのみサポートされます。
送信時
ユーザーがデバイス マネージャーのデバイスの [トラブルシューティング] ボタンをクリックしたとき。
処理するユーザー
クラス共同インストーラー |
処理できる |
デバイス共同インストーラー |
処理できる |
クラスインストーラー |
処理できる |
インストーラーによる入力
DeviceInfoSet
デバイスを格納している デバイス情報セット へのハンドルが提供されます。
DeviceInfoData
デバイス情報セット内のデバイスを識別する SP_DEVINFO_DATA 構造体へのポインターが提供されます。
デバイスインストールパラメーター
DeviceInfoData に関連付けられているデバイス インストール パラメーター (SP_DEVINSTALL_PARAMS) があります。
クラスインストールパラメーター
SP_TROUBLESHOOTER_PARAMS構造体は DeviceInfoData に関連付けられています。
インストーラーによる出力
クラスインストールパラメーター
インストーラーは、CHM または HTML ファイルを 設定して、SP_TROUBLESHOOTER_PARAMSを変更する場合があります。
インストーラーの戻り値
共同インストーラーがこの 要求を処理しない場合、前処理パスから NO_ERROR を返します。
共同インストーラーがこの要求を処理する場合は、後処理パスで処理されます。 共同インストーラーが CHM ファイルと HTML ファイルを提供すると、受信した状態 (おそらく ERROR_DI_DO_DEFAULT) が伝達されます。 共同インストーラーがトラブルシューティング ツールを実行して問題を解決した場合、共同インストーラーは NO_ERROR を返します。 共同インストーラーでトラブルシューティング ツールを実行しても問題が解決しない場合は、受信した状態 (ERROR_DI_DO_DEFAULT) が伝達されます。
クラス インストーラーが CHM ファイルと HTML ファイルを提供する場合、またはクラス インストーラーがトラブルシューティング ツールを実行しても問題が解決しない場合、クラス インストーラーは ERROR_DI_DO_DEFAULT を返します。 その後、Windows は既定のハンドラーを呼び出します。
クラス インストーラーが独自のトラブルシューティング ツールを起動して問題を解決すると、クラス インストーラーは NO_ERROR を返します。 その後、Windows は既定のハンドラーを呼び出しません。
クラス インストーラーでエラーが発生した場合、インストーラーは適切な Win32 エラー コードを返します。 その後、Windows は既定のハンドラーを呼び出しません。
既定の DIF コードハンドラー
なし
DIF_TROUBLESHOOTER の既定のハンドラーはありませんが、オペレーティング システムには、インストーラーが提供するトラブルシューティング ツールがない場合にデバイスの問題を解決しようとする既定のトラブルシューティング ツールが用意されています。
インストーラー操作
インストーラーは CM_Get_DevNode_Status を呼び出して、デバイスの状態と CM の問題コードを取得します。 問題によっては、インストーラーによってトラブルシューティング ツール、ヘルプ ファイル、または何も提供されない場合があります。 トラブルシューティング ツールは、デバイスの問題を解決できる可能性があります。 トラブルシューティング ツールで問題が解決された場合は、SetupDiCallClassInstaller を呼び出して、DICS_PROPCHANGE 型の DIF_PROPERTYCHANGE 要求を送信する必要があります。 インストーラーがデバイスのトラブルシューティング ツールを提供していない場合は、ユーザーに対する問題解決の提案のヘルプ ファイルが提供される可能性があります。
インストーラーが独自のトラブルシューティング ツールを実行していない場合、Windows は HTML ヘルプを実行してユーザーに情報を表示します。 インストーラーがクラス インストール パラメーターに CHM ファイルを指定した場合、Windows はそのファイルを表示します。 それ以外の場合、Windows はシステム提供のトラブルシューティング情報を表示します。
クラスのインストール パラメーターには、ChmFile と HtmlTroubleShooter のペアが最大 1 つ含まれています。 複数のインストーラーでこれらの値が指定されている場合、Windows は DIF 要求を処理した最後のインストーラーによって設定された値を使用します。
DIF コードの詳細については、「DIF コードの処理」を参照してください。
要件
バージョン |
Windows Server 2003、Windows XP、および Microsoft Windows 2000 でサポートされます。 |
ヘッダー |
Setupapi.h (Setupapi.h を含む) |