SetupDiInstallDeviceInterfaces 函数 (setupapi.h)

  • 项目

SetupDiInstallDeviceInterfaces 函数是DIF_INSTALLINTERFACES安装请求的默认处理程序。

语法

WINSETUPAPI BOOL SetupDiInstallDeviceInterfaces(
  [in] HDEVINFO         DeviceInfoSet,
  [in] PSP_DEVINFO_DATA DeviceInfoData
);

参数

[in] DeviceInfoSet

指向 设备信息集 的指针，其中包含表示要为其安装接口的设备的设备信息元素。 设备信息集必须仅包含本地系统的元素。

[in] DeviceInfoData

指向 SP_DEVINFO_DATA 结构的指针，该结构指定 DeviceInfoSet 中的设备信息元素。

返回值

如果函数完成且未出错，SetupDiInstallDeviceInterfaces 将返回 TRUE。 如果函数完成但出现错误，则返回 FALSE ，并且可以通过调用 GetLastError 来检索失败的错误代码。

注解

SetupDiInstallDeviceInterfaces 处理 DDInstall 中的每个 AddInterface 条目。设备 INF 文件的接口部分，通过调用 SetupDiCreateDeviceInterface 创建每个接口。

SetupDiInstallDeviceInterfaces 的调用方必须是 Administrators 组的成员。

注意 只有 类安装程序 应调用 SetupDiInstallDeviceInterfaces ，并且仅在类安装程序必须在 SetupDiInstallDeviceInterfaces 完成默认设备接口安装操作后执行设备接口安装操作的情况下调用。 在这种情况下，当安装程序处理DIF_INSTALLINTERFACES请求时，类安装程序必须直接调用 SetupDiInstallDeviceInterfaces 。 有关调用默认处理程序的详细信息，请参阅 调用默认 DIF 代码处理程序。
 
有关 INF 文件格式的信息，请参阅 INF 文件节和指令。

要求

要求 值
最低受支持的客户端 在 Microsoft Windows 2000 及更高版本的 Windows 中可用。
目标平台 桌面
标头 setupapi.h (包括 Setupapi.h)
Library Setupapi.lib
DLL Setupapi.dll

另请参阅

DIF_INSTALLINTERFACES

SetupDiCreateDeviceInterface