DIF_TROUBLESHOOTER

项目
06/15/2023

DIF_TROUBLESHOOTER请求允许安装程序启动设备的疑难解答，或返回 CHM 和 HTM 疑难解答文件，以便 Windows 启动。

注意此 DIF 代码仅在 Windows Server 2003、Windows XP 和 Microsoft Windows 2000 上受支持。

发送时

当用户在设备管理器中单击设备的“疑难解答”按钮时。

谁处理

类共同安装程序	可以处理
设备共同安装程序	可以处理
类安装程序	可以处理

安装程序输入

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

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

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

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

安装程序输出

类安装参数
安装程序可能会修改 SP_TROUBLESHOOTER_PARAMS，设置 CHM 或 HTML 文件。

安装程序返回值

如果共同安装程序不处理此请求，它将从其预处理阶段返回NO_ERROR。

如果共同安装程序处理此请求，则它会在其后处理阶段执行此操作。如果共同安装程序提供 CHM 和 HTML 文件，它会传播它收到的状态 (可能ERROR_DI_DO_DEFAULT) 。如果共同安装程序运行疑难解答并修复了问题，则共同安装程序将返回NO_ERROR。如果共同安装程序运行故障排除程序但未解决问题，它将传播 (ERROR_DI_DO_DEFAULT) 收到的状态。

如果类安装程序提供 CHM 文件和 HTML 文件，或者类安装程序运行疑难解答但未解决问题，则类安装程序将返回ERROR_DI_DO_DEFAULT。 Windows 随后将调用默认处理程序。

如果类安装程序启动自己的疑难解答并修复了问题，则类安装程序将返回NO_ERROR。 Windows 随后不会调用默认处理程序。

如果类安装程序遇到错误，安装程序将返回相应的 Win32 错误代码。 Windows 随后不会调用默认处理程序。

默认 DIF 代码处理程序

无

DIF_TROUBLESHOOTER没有默认处理程序，但操作系统提供默认的疑难解答程序，如果没有安装程序提供的疑难解答程序，则尝试解决设备问题。

安装程序操作

安装程序调用 CM_Get_DevNode_Status 以获取设备状态和 CM 问题代码。根据问题，安装程序可能会提供疑难解答、帮助文件或什么内容。疑难解答可以解决设备问题。如果疑难解答解决了该问题，它应调用 SetupDiCallClassInstaller 以发送DICS_PROPCHANGE类型的DIF_PROPERTYCHANGE请求。如果安装程序未为设备提供疑难解答，它可能会向用户提供解决问题建议的帮助文件。

如果没有安装程序运行自己的疑难解答，Windows 将运行 HTML 帮助向用户显示信息。如果安装程序在类安装参数中提供了 CHM 文件，Windows 将显示该文件。否则，Windows 将显示系统提供的故障排除信息。

类安装参数最多包含一个 ChmFile 和 HtmlTroubleShooter 对。如果多个安装程序指定这些值，Windows 将使用最后一个处理 DIF 请求的安装程序设置的值。

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