DIF_ALLOW_INSTALL

系统DIF_ALLOW_INSTALL请求会询问设备的安装程序Windows是否可以继续安装该设备。

发送时间

为设备选择驱动程序之后,但在安装设备之前。

Who句柄

类共同安装程序

可以处理

设备共同安装程序

不应处理

类安装程序

可以处理

安装程序输入

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

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

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

类安装参数

安装程序输出

没有

安装程序返回值

共同安装程序可能会返回NO_ERROR Win32 错误。 对于此 DIF 请求,ERROR_DI_POSTPROCESSING_REQUIRED安装程序不应返回该请求。

类安装程序通常返回ERROR_DI_DO_DEFAULT Win32 错误代码。

此 DIF 请求的典型 Win32 错误代码包括ERROR_DI_DONT_INSTALL ERROR_NON_WINDOWS_NT_DRIVER。

注意 类安装程序和共同安装程序不应ERROR_REQUIRES_INTERACTIVE_WINDOWSTATION,因为这会导致设备安装失败。 如果设备安装需要用户交互,类安装程序和共同安装程序应支持 完成安装操作

默认 DIF 代码处理程序

安装程序操作

为了响应DIF_ALLOW_INSTALL安装程序确认Windows安装设备。

如果安装程序确定所选驱动程序不正确 (例如,如果驱动程序是仅在 Windows 9 倍的驱动程序,而该驱动程序在基于 NT 的操作系统) 上无法正常工作,或者确定所选驱动程序已知存在 bug,则安装程序可能会失败此请求。

如果在设备安装参数中设置了 DI_QUIETINSTALL 标志,并且安装程序在设备安装过程中必须显示 UI,则安装程序可能会失败此请求。 但是,这种失败很少见,因为安装程序通常提供任何 UI 页面来响应DIF_NEWDEVICEWIZARD_FINISHINSTALL请求。 在这种情况下,UI 不会阻止安装程序成功执行DIF_ALLOW_INSTALL设置静默标志的请求。 但是,如果安装程序无法将其 UI 限制为完成安装情况,则如果设置了 DI_QUIETINSTALL 标志,则安装程序必须失败此 DIF 请求。 例如,如果安装程序调用供应商提供的代码来显示 UI,则安装程序可能有此限制。

如果安装程序未通过此 DIF 请求,Windows停止安装。

如果安装程序未通过此 DIF 请求DI_QUIETINSTALL未在设备安装参数中设置此参数,则安装程序应显示一个对话框,其中会显示一条消息,说明未安装设备的原因。

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

要求

版本

Microsoft Windows 2000 及更高版本的 Windows。

标头

Setupapi.h (包括 Setupapi.h)

另请参阅

SP_DEVINFO_DATA

SP_DEVINSTALL_PARAMS