DIF_UNREMOVE

DIF_UNREMOVE请求通知安装程序 Windows 将恢复给定硬件配置文件中的设备,并为安装程序提供参与操作的机会。 Windows 仅针对非 PnP 设备发送此请求。

发送时

将根枚举的非 PnP 设备恢复为硬件配置文件时。

谁处理

类共同安装程序

可以处理

设备共同安装程序

可以处理

类安装程序

可以处理

安装程序输入

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

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

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

类安装参数
SP_UNREMOVEDEVICE_PARAMS结构与 DeviceInfoData 相关联。 范围字段必须设置为 DI_UNREMOVEDEVICE_CONFIGSPECIFIC并且必须在 HwProfile 字段中指定硬件配置文件。

安装程序输出

安装程序返回值

共同安装程序可以返回NO_ERROR、ERROR_DI_POSTPROCESSING_REQUIRED或 Win32 错误代码。

如果类安装程序成功处理此请求,并且 SetupDiCallClassInstaller 随后应调用默认处理程序,则类安装程序将返回ERROR_DI_DO_DEFAULT。

如果类安装程序成功处理此请求(包括直接调用默认处理程序),则类安装程序应返回NO_ERROR并且 SetupDiCallClassInstaller 随后不会再次调用默认处理程序。

注意 类安装程序可以直接调用默认处理程序,但类安装程序不应尝试取代默认处理程序的操作。

有关调用默认处理程序的详细信息,请参阅 调用默认 DIF 代码处理程序

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

默认 DIF 代码处理程序

SetupDiUnremoveDevice

安装程序操作

“取消删除”设备基本上意味着 Windows 清除之前在特定硬件配置文件中将设备标记为“不存在”的标志。

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

要求

版本

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

标头

Setupapi.h (包括 Setupapi.h)

另请参阅

SetupDiUnremoveDevice

SP_DEVINFO_DATA

SP_DEVINSTALL_PARAMS

SP_UNREMOVEDEVICE_PARAMS