DIF_NEWDEVICEWIZARD_PRESELECT
DIF_NEWDEVICEWIZARD_PRESELECT 要求を使用すると、インストーラーは、ドライバーの選択ページを表示する前に、Windows がユーザーに表示するウィザード ページを提供できます。 この要求は、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_NEWDEVICEWIZARD_PRESELECT 要求を使用すると、インストーラーは、ドライバーの選択ページを表示する前に、Windows がユーザーに表示するウィザード ページを提供できます。 この要求は、PnP 以外のデバイスの手動インストール中にのみ使用されます。
インストーラーがカスタムの preselect ページを追加する場合、インストーラーはまず、クラスのインストール パラメーターの NumDynamicPages がMAX_INSTALLWIZARD_DYNAPAGES に達したかどうかをチェックする必要があります。
共同インストーラーは、前処理パスまたは後処理パスにカスタム ページを追加できます。 プリプロセス パスにページを追加した場合、クラス インストーラーによって提供されるページの前にそれらのページが表示されます。
1 つ以上のインストーラーがカスタムの事前選択ページを追加する場合、Windows は [デバイス ドライバーの選択] ページの前にページを表示します。 ただし、ユーザーがドライバーの選択ページで [戻る] を押した場合、Windows はカスタムの事前選択ページをスキップし、[ハードウェアの種類] クラスの選択ページに戻ります。
インストーラーは、カスタム ウィザード ページの PROPSHEETPAGE 構造体に、Wizard 97 ヘッダー タイトルとヘッダー サブタイトルを提供する必要があります。 インストーラーは、システムが提供するウィザードのタイトルを置き換えてはなりません。 PROPSHEETPAGE 構造体のドキュメントとプロパティ ページの詳細については、「Microsoft Windows SDK」 を参照してください。
DIF コードの詳細については、「DIF コードの処理」を参照してください。
要件
バージョン |
Microsoft Windows 2000 以降のバージョンの Windows でサポートされています。 |
ヘッダー |
Setupapi.h (Setupapi.h を含む) |
関連項目
DIF_NEWDEVICEWIZARD_PREANALYZE