DIF_INSTALLINTERFACES

DIF_INSTALLINTERFACES请求允许安装程序参与设备接口的注册。

发送时

在注册设备共同安装程序之后,但在完成设备安装之前。

谁处理

类共同安装程序

可以处理

设备共同安装程序

可以处理

类安装程序

可以处理

安装程序输入

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

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

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

类安装参数

安装程序输出

设备安装参数
安装程序可能会修改设备安装参数,但通常不适用于此 DIF 请求。

安装程序返回值

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

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

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

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

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

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

默认 DIF 代码处理程序

SetupDiInstallDeviceInterfaces

安装程序操作

为了响应DIF_INSTALLINTERFACES请求,安装程序可能以编程方式注册设备接口,而不是通过 INF 文件注册接口。 通常,供应商提供的安装程序不会处理此 DIF 请求。

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

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

如果安装程序注册设备接口(例如设备的内核模式组件 (),驱动程序) 必须调用 IoSetDeviceInterfaceState 才能启用接口。

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

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

要求

版本

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

标头

Setupapi.h (包括 Setupapi.h)

另请参阅

SetupDiInstallDeviceInterfaces

SP_DEVINFO_DATA

SP_DEVINSTALL_PARAMS