次の方法で共有


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

DIF_NEWDEVICEWIZARD_POSTANALYZE

DIF_NEWDEVICEWIZARD_SELECT

SP_DEVINFO_DATA

SP_DEVINSTALL_PARAMS

SP_NEWDEVICEWIZARD_DATA