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) |