INF InterfaceInstall32 节
本部分创建一个或多个新的 设备接口类。 创建新类后,随后安装的设备/驱动程序可以通过调用 IoRegisterDeviceInterface 来注册对新设备接口类的支持。
[InterfaceInstall32]
{InterfaceClassGUID}=install-interface-section[,flags]
...
项
InterfaceClassGUID
指定标识新导出 的设备接口类的 GUID 值。
若要注册接口类的实例,设备的驱动程序必须使用此 GUID 调用 IoRegisterDeviceInterface 。 本部分中的指定 GUID 值也可以由 INFDDInstall 中的 INF AddInterface 指令引用。“接口”部分。
有关如何创建 GUID 的详细信息,请参阅 在驱动程序中使用 GUID。 有关系统定义的接口类 GUIDS,请参阅相应的标头,例如内核流式处理接口的 Ks.h 。
install-interface-section
引用此 INF 中的其他位置的 INF 编写器定义的节(可能包含任何系统定义的扩展)。
flag
如果指定,则此项必须为零。
注解
当系统中尚未安装指定的 InterfaceClassGUID 时,该接口类将作为相应的 DDInstall 安装。接口部分在设备安装期间或设备驱动程序对 IoRegisterDeviceInterface 进行初始调用时进行处理。
每个 install-interface-section 名称在 INF 文件中必须是唯一的,并且必须遵循定义节名称的一般规则。 有关这些规则的详细信息,请参阅 INF 文件的一般语法规则。
任何指定的 install-interface-section 具有以下常规形式:
[interface-install-section] |
[interface-install-section.nt] |
[interface-install-section.ntx86] |
[interface-install-section.ntia64] | (Windows XP and later versions of Windows)
[interface-install-section.ntamd64] | (Windows XP and later versions of Windows)
[interface-install-section.ntarm] | (Windows 8 and later versions of Windows)
[interface-install-section.ntarm64] (Windows 10 and later versions of Windows)
AddReg=add-registry-section[, add-registry-section] ...
[AddProperty=add-property-section[, add-property-section] ...] (Windows Vista and later versions of Windows)
[Copyfiles=@filename | file-list-section[, file-list-section] ...]
[DelReg=del-registry-section[, del-registry-section] ...]
[DelProperty=del-property-section[, del-property-section] ...] (Windows Vista and later versions of Windows)
[BitReg=bit-registry-section[,bit-registry-section]...]
[Delfiles=file-list section[, file-list-section] ...]
[Renfiles=file-list-section[, file-list-section] ...]
[UpdateInis=update-ini-section[,update-ini-section]...]
[UpdateIniFields=update-inifields-section[,update-inifields-section]...]
[Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...]
...
有关 interface-install-section 中的条目的详细信息,请参阅 INF DDInstall 节。
从 Windows Vista 开始,可以通过在 interface-install 节中包含 INF AddProperty 指令来设置设备接口类属性。 还可以通过在 interface-install 节中包含 INF DelProperty 指令 来删除设备接口类属性。 但是,应仅使用 AddProperty 或 DelProperty 指令来修改 Windows Vista 或更高版本 Windows 操作系统中新增的设备接口类属性。 对于在 Windows Server 2003、Windows XP 或 Windows 2000 上引入且具有相应注册表项的设备接口类属性,应继续使用 INF AddReg 指令 和 INF DelReg 指令 来设置和删除设备接口类属性。 这些准则适用于系统定义的属性和自定义属性。 有关如何使用 AddProperty 指令和 DelProperty 指令的详细信息,请参阅 使用 INF AddProperty 指令和 INF DelProperty 指令。
AddReg 指令引用一个或多个 add-registry 节,这些节在安装此接口期间在注册表中设置特定于设备接口的信息。
有关此接口类的注册表信息应至少包括新 设备接口类 的友好名称,以及更高级别的组件在打开并使用此接口时所需的任何信息。
此外,此类 install-interface-section 可能使用此处所示的任何可选指令来指定特定于接口的安装操作。
有关如何使用系统定义的 .nt、 .ntx86、 .ntia64、 .ntamd64、 .ntarm、 .ntarm64 扩展的详细信息,请参阅 为多个平台和操作系统创建 INF 文件。