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 代码处理程序
安装程序操作
为了响应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) |