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) |