DIF_NEWDEVICEWIZARD_SELECT

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

DIF_NEWDEVICEWIZARD_SELECT 要求を使用すると、インストーラーは標準のドライバー選択ページを置き換えるカスタムウィザードページを提供できます。この要求は、PnP 以外のデバイスの手動インストール中にのみ使用されます。

送信時

Windows が [デバイスドライバーの選択] ページを表示する直前。

処理するユーザー

クラス共同インストーラー	処理できる
デバイス共同インストーラー	取り扱いなし
クラスインストーラー	処理できる

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

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

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

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

クラスインストールパラメーター
SP_NEWDEVICEWIZARD_DATA構造体は DeviceInfoData に関連付けられています。

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

デバイスインストールパラメーター
インストーラーは、デバイスのインストールパラメーターのフラグを変更できます。 Windows は、この DIF 要求の完了時にフラグをチェックしません。ただし、インストールプロセスの後半でチェックされます。

クラスインストールパラメーター
インストーラーは、SP_NEWDEVICEWIZARD_DATA を変更し、カスタムページを提供することができます。

インストーラーの戻り値

共同インストーラーがこの DIF 要求を処理しない場合、前処理パスから NO_ERROR を返します。共同インストーラーがこの要求を処理する場合は、NO_ERROR、ERROR_DI_POSTPROCESSING_REQUIRED、または Win32 エラーコードを返すことができます。

クラスインストーラーは、ページが正常に提供された場合には NO_ERROR を返します。そうでない場合、クラスインストーラーは ERROR_DI_DO_DEFAULT または Win32 エラーコードを返します。

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

なし

インストーラー操作

インストーラーはこの DIF 要求に応答し、標準のドライバー選択ウィザードページを完全に置き換えます。代わりに、インストーラーが標準ページを変更するか、選ぶドライバーの一覧を変更する必要がある場合は、インストーラーは、DIF_SELECTDEVICE 要求に応答して行う必要があります。

共同インストーラーは、クラスインストーラーがカスタムページを追加しなかった場合にのみ、後処理パスにカスタムページを追加する必要があります。クラスインストーラーがページを追加した場合、共同インストーラーは追加しないでください。そうでない場合、ユーザーはドライバーを 2 回選ぶように求められる場合があります。

インストーラーがカスタム選択ページを提供する場合、インストーラーは選んだドライバーを設定する必要があります。ウィザードページをサポートするインストーラーのコードで、ユーザーが [次へ] をクリックした後、インストーラーは SetupDiSetSelectedDriver を呼び出す必要があります。

インストーラーは、カスタムウィザードページの PROPSHEETPAGE 構造体に、Wizard 97 ヘッダータイトルとヘッダーサブタイトルを提供する必要があります。インストーラーは、システムが提供するウィザードのタイトルを置き換えてはなりません。 PROPSHEETPAGE 構造体のドキュメントとプロパティページの詳細については、「Microsoft Windows SDK」を参照してください。

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

要件

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

次の方法で共有