DIF_REGISTER_COINSTALLERS

DIF_REGISTER_COINSTALLERS请求允许安装程序参与设备辅助安装程序的注册。

发送时间

在完成设备安装之前。

谁处理

类辅助安装程序

可以处理

设备辅助安装程序

不处理

类安装程序

可以处理

安装程序输入

DeviceInfoSet
提供设备信息集的句柄,该 设备信息集 包含要为其注册辅助安装程序的设备。

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

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

类安装参数

安装程序输出

安装程序返回值

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

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

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

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

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

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

默认 DIF 代码处理程序

SetupDiRegisterCoDeviceInstallers

安装程序操作

在响应DIF_REGISTER_COINSTALLERS请求时,安装程序可能会修改设备的辅助安装程序列表。 例如,安装程序可能会以编程方式为基于设备分析的设备注册或删除特定于设备的辅助安装程序。

除非设置了DI_NOFILECOPY标志,否则处理此 DIF 请求的安装程序应复制辅助安装程序 () 所需的文件。

如果DI_NOFILECOPY标志为清除,但设置了DI_NOVCP标志,则安装程序必须将所有文件操作排入所提供的文件队列,但不得提交队列。

如果安装程序返回 Win32 错误代码,Windows 将停止安装。

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

要求

版本

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

标头

Setupapi.h (包括 Setupapi.h)

另请参阅

SetupDiRegisterCoDeviceInstallers

SP_DEVINFO_DATA

SP_DEVINSTALL_PARAMS