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 代码处理程序
安装程序操作
“取消删除”设备基本上意味着 Windows 清除之前在特定硬件配置文件中将设备标记为“不存在”的标志。
有关 DIF 代码的详细信息,请参阅 处理 DIF 代码。
要求
版本 |
在 Microsoft Windows 2000 及更高版本的 Windows 中受支持。 |
标头 |
Setupapi.h (包括 Setupapi.h) |