DIF_NEWDEVICEWIZARD_PREANALYZE

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

发送时

在用户选择驱动程序之后,但在 Windows 注册使设备节点 (devnode) “实时”的设备。

谁处理

类共同安装程序

可以处理

设备共同安装程序

不处理

类安装程序

可以处理

安装程序输入

DeviceInfoSet
为包含 该设备的设备信息集 提供句柄。

DeviceInfoData
提供指向 SP_DEVINFO_DATA 结构的指针,该结构标识设备信息集中的设备。

设备安装参数
设备安装参数 (SP_DEVINSTALL_PARAMS) 与 DeviceInfoData 相关联。

类安装参数
SP_NEWDEVICEWIZARD_DATA结构与 DeviceInfoData 相关联。

安装程序输出

设备安装参数
安装程序可以修改设备安装参数中的标志。 完成此 DIF 请求后,Windows 不会检查标志。 但是,它会在安装过程中稍后检查它们。

类安装参数
安装程序可以修改 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 显示的向导页。 这些页面可视为“后选”页面。 此请求仅在手动安装非 PnP 设备期间使用。

例如,安装程序可能会使用自定义预分析页来选择调制解调器设备之后的 COM 端口。

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

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

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

要求

版本

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

标头

Setupapi.h (包括 Setupapi.h)

另请参阅

DIF_NEWDEVICEWIZARD_PRESELECT

DIF_NEWDEVICEWIZARD_POSTANALYZE

DIF_NEWDEVICEWIZARD_SELECT

SP_DEVINFO_DATA

SP_DEVINSTALL_PARAMS

SP_NEWDEVICEWIZARD_DATA