DIF_UNREMOVE

[アーティクル]
04/02/2024

DIF_UNREMOVE 要求は、Windows が特定のハードウェアプロファイル内のデバイスを復元しようとしていることをインストーラーに通知し、インストーラーに操作に参加する機会を与えます。 Windows は、PnP 以外のデバイスに対してのみこの要求を送信します。

送信時

ルート列挙の場合、PnP 以外のデバイスはハードウェアプロファイルに復元されます。

処理するユーザー

クラス共同インストーラー	処理できる
デバイス共同インストーラー	処理できる
クラスインストーラー	処理できる

インストーラーによる入力

DeviceInfoSet
デバイスを格納しているデバイス情報セットへのハンドルが提供されます。

DeviceInfoData
デバイス情報セット内のデバイスを識別する SP_DEVINFO_DATA 構造体へのポインターが提供されます。

デバイスインストールパラメーター
DeviceInfoData に関連付けられているデバイスインストールパラメーター (SP_DEVINSTALL_PARAMS) があります。

クラスインストールパラメーター
SP_UNREMOVEDEVICE_PARAMS構造体は DeviceInfoData に関連付けられています。 [スコープ] フィールドを DI_UNREMOVEDEVICE_CONFIGSPECIFIC に設定し、[HwProfile] フィールドにハードウェアプロファイルを指定する必要があります。

インストーラーによる出力

なし

インストーラーの戻り値

共同インストーラーは、NO_ERROR、ERROR_DI_POSTPROCESSING_REQUIRED、または Win32 エラーコードを返すことができます。

クラスインストーラーがこの要求を正常に処理し、その後 SetupDiCallClassInstaller が既定のハンドラーを呼び出す必要がある場合、クラスインストーラーは ERROR_DI_DO_DEFAULT を返します。

既定のハンドラーの直接呼び出しを含め、クラスインストーラーがこの要求を正常に処理した場合、クラスインストーラーは NO_ERROR を返す必要があり、その後 SetupDiCallClassInstaller は既定のハンドラーをもう一度呼び出しません。

注: クラスインストーラーは既定のハンドラーを直接呼び出すことができますが、クラスインストーラーは既定のハンドラーの操作を置き換えようとしないでください。

既定のハンドラーの呼び出しの詳細については、「既定の DIF コードハンドラーの呼び出し」を参照してください。

クラスインストーラーでエラーが見つかった場合、インストーラーは適切な Win32 エラーコードを返す必要があり、SetupDiCallClassInstaller は既定のハンドラーを呼び出しません。

既定の DIF コードハンドラー

SetupDiUnremoveDevice

インストーラー操作

デバイスを「移動しない」とは、基本的に、特定のハードウェアプロファイルで以前にデバイスを「存在しない」とマークしたフラグが Windows によってクリアされることを意味します。

DIF コードの詳細については、「DIF コードの処理」を参照してください。

要件

バージョン	Microsoft Windows 2000 以降のバージョンの Windows でサポートされています。
ヘッダー	Setupapi.h (Setupapi.h を含む)

次の方法で共有