DIF_NEWDEVICEWIZARD_SELECT
DIF_NEWDEVICEWIZARD_SELECT请求允许安装程序提供自定义向导页 (替换标准选择驱动程序页的) 。 此请求仅在手动安装非 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_SELECT请求允许安装程序提供自定义向导页 (替换标准选择驱动程序页的) 。 此请求仅在手动安装非 PnP 设备期间使用。
安装程序会响应此 DIF 请求，以完全替换标准选择驱动程序向导页。 相反，如果安装程序只需修改标准页或修改要从中选择的驱动程序列表，则安装程序应这样做以响应 DIF_SELECTDEVICE 请求。
仅当类安装程序未 () 添加自定义页面时，共同安装程序应在其后处理阶段添加自定义页面 () 。 如果类安装程序添加了页 () ，则辅助安装程序不应添加页。 否则，系统可能会要求用户选择驱动程序两次。
如果安装程序提供自定义选择页，则安装程序必须设置所选驱动程序。 在支持向导页的安装程序代码中，用户单击“ 下一步”后，安装程序必须调用 SetupDiSetSelectedDriver。
安装程序应在自定义向导页的 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。
提交和查看相关反馈