INF InterfaceInstall32 节

项目
06/15/2023

本部分创建一个或多个新的设备接口类。创建新类后，随后安装的设备/驱动程序可以通过调用 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 指令。