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 指令 来删除设备接口类属性。 但是,应仅使用 AddPropertyDelProperty 指令来修改 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 文件

另请参阅

AddProperty

AddReg

BitReg

ClassInstall32

CopyFiles

DDInstall

DDInstall。接口

DelFiles

DelProperty

DelReg

Ini2Reg

IoRegisterDeviceInterface

RenFiles

UpdateIniFields

UpdateInis