DIF_NEWDEVICEWIZARD_PREANALYZE

DIF_NEWDEVICEWIZARD_PREANALYZE 请求允许安装程序提供 Windows 向用户显示的向导页,然后显示 "分析" 页。 此请求仅在手动安装非 PnP 设备期间使用。

发送时间

用户选择了驱动程序,但在 Windows 注册使设备节点 (devnode) "live" 的设备之前。

Who 句柄

类共同安装程序

可以处理

设备共同安装程序

不处理

类安装程序

可以处理

安装程序输入

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_PREANALYZE 请求允许安装程序提供 Windows 向用户显示的向导页,然后显示 "分析" 页。 可以将这些页面视为 "postselect" 页面。 此请求仅在手动安装非 PnP 设备期间使用。

例如,安装程序可能使用自定义的 preanalyze 页面,以选择调制解调器设备后选择 COM 端口。

如果安装程序将自定义预选页添加) (,则安装程序应首先检查是否已达到 MAX_INSTALLWIZARD_DYNAPAGES 类安装参数中的 NumDynamicPages

安装程序应在自定义向导页的 PROPSHEETPAGE 结构中提供向导97标题标题和标题副标题。 安装程序不应替换系统提供的向导标题。 请参阅 PROPSHEETPAGE 结构的相关文档的 Microsoft Windows SDK,并了解有关属性页的详细信息。

有关 DIF 代码的详细信息,请参阅 处理 Dif 代码

要求

版本

在 Microsoft Windows 2000 及更高版本的 Windows 中受支持。

标头

Setupapi.log (包含 Setupapi.log)

另请参阅

DIF_NEWDEVICEWIZARD_PRESELECT

DIF_NEWDEVICEWIZARD_POSTANALYZE

DIF_NEWDEVICEWIZARD_SELECT

SP_DEVINFO_DATA

SP_DEVINSTALL_PARAMS

SP_NEWDEVICEWIZARD_DATA