DIF_NEWDEVICEWIZARD_PRESELECT
DIF_NEWDEVICEWIZARD_PRESELECT请求允许安装程序提供 Windows 在显示选择驱动程序页之前向用户显示的向导页。 此请求仅在手动安装非 PnP 设备期间使用。
发送时间
在用户为设备选择类之后，但在 Windows 之前显示“选择设备驱动程序”页。
谁处理
类辅助安装程序 |
可以处理 |
设备辅助安装程序 |
不处理 |
类安装程序 |
可以处理 |
安装程序输入
DeviceInfoSet
提供包含 设备的设备信息集 的句柄。
DeviceInfoData
提供指向 SP_DEVINFO_DATA 结构的指针，该结构标识设备信息集中的设备。
设备安装参数
有与 DeviceInfoData 关联的SP_DEVINSTALL_PARAMS) (设备安装参数。
类安装参数
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_PRESELECT请求允许安装程序提供 Windows 在显示选择驱动程序页之前向用户显示的向导页。 此请求仅在手动安装非 PnP 设备期间使用。
如果安装程序 () 添加自定义预选择页，则安装程序应首先检查类安装参数中的 NumDynamicPages 是否已达到MAX_INSTALLWIZARD_DYNAPAGES。
协同安装程序可以在其预处理阶段和/或其后处理阶段中添加自定义页面。 如果它在预处理阶段添加页 () ，则这些页面将显示在类安装程序提供的任何页 () 之前。
如果一个或多个安装程序添加自定义预选择页，Windows 会在“选择设备驱动程序”页之前显示页面。 但是，如果用户在选择驱动程序页面上按“后退”，Windows 将跳过自定义预选择页，并返回到“硬件类型”类选择页。
安装程序应在自定义向导页的 PROPSHEETPAGE 结构中提供 Wizard 97 标头标题和标题副标题。 安装程序不应替换系统提供的向导标题。 有关 PROPSHEETPAGE 结构的文档和有关属性页的详细信息，请参阅Microsoft Windows SDK。
有关 DIF 代码的详细信息，请参阅 处理 DIF 代码。
要求
版本 |
在 Microsoft Windows 2000 及更高版本的 Windows 中受支持。 |
标头 |
Setupapi.h (包括 Setupapi.h) |
另请参阅
DIF_NEWDEVICEWIZARD_PREANALYZE
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈