DIF_REMOVE

DIF_REMOVE请求通知安装程序Windows即将删除设备,并让安装程序有机会准备删除。

发送时间

当用户删除设备管理器中的设备时。

谁处理

类共同安装程序

可以处理

设备共同安装程序

可以处理

类安装程序

可以处理

安装程序输入

DeviceInfoSet
为包含要删除 的设备的设备信息集 提供句柄。

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

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

类安装参数
SP_REMOVEDEVICE_PARAMS结构可能与 DeviceInfoData 相关联。

如果DI_CLASSINSTALLPARAMS标志在 SP_DEVINSTALL_PARAMS中清除,则请求没有类安装参数。 在这种情况下,未指定任何硬件配置文件,并且设备将从整个系统中删除。

安装程序输出

无

安装程序返回值

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

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

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

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

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

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

默认 DIF 代码处理程序

SetupDiRemoveDevice

安装程序操作

为了响应DIF_REMOVE请求,安装程序通常会执行一些清理操作。 在这种情况下,共同安装程序返回NO_ERROR,类安装程序返回ERROR_DI_DO_DEFAULT。

如果安装程序确定不应删除设备,安装程序会通过返回 Win32 错误代码来失败 DIF 请求。 如果DI_QUIETINSTALL标志明确,安装程序应向用户显示一条消息,说明为何未删除设备。

共同安装程序不得尝试通过调用 SetupDiRemoveDevice 来自行删除设备。 成功删除设备后,共同安装程序通常会在后处理中处理此请求。

例如,如果共同安装程序必须删除注册表中的信息,则共同安装程序应在后处理中执行此操作,并且仅当以前的安装程序成功删除请求时。 在其预处理传递中,共同安装程序应将其注册表信息存储在其上下文参数中,并返回ERROR_DI_POSTPROCESSING_REQUIRED以请求后处理。 当Windows调用共同安装程序以处理此 DIF 请求时,共同安装程序应检查 DIF 状态是否NO_ERROR,然后删除注册表信息。 如果共同安装程序删除其预处理传递中的注册表信息,并且类安装程序(或其他共同安装程序)将失败DIF_REMOVE,则共同安装程序可能会使设备处于不可预知的状态。

处理此 DIF 请求时,安装程序不应删除文件,以防其他设备正在使用这些文件。

Windows在启动 PnP 查询删除和删除处理之前发送此 DIF 请求。

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

要求

Version

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

Header

Setupapi.h (包括 Setupapi.h)

另请参阅

SetupDiRemoveDevice

SP_DEVINFO_DATA

SP_DEVINSTALL_PARAMS

SP_REMOVEDEVICE_PARAMS