INF Ini2Reg 指令

注意

从 Windows 11 版本 22H2 开始,使用此指令的驱动程序包不再符合从硬件开发人员中心获得签名的条件。

通用驱动程序包Windows 驱动程序不能使用此指令。

Ini2Reg 指令引用一个或多个已命名的部分,将提供的 INI 文件中的行或部分移入注册表。 这将创建或替换指定项下的一个或多个值项。

[DDInstall] | 
[DDInstall.CoInstallers] | 
[ClassInstall32] | 
[ClassInstall32.ntx86] | 
[ClassInstall32.ntia64] | (Windows XP and later versions of Windows)
[ClassInstall32.ntamd64] | (Windows XP and later versions of Windows)
[ClassInstall32.ntarm] | (Windows 8 and later versions of Windows)
[ClassInstall32.ntarm64] (Windows 10 version 1709 and later versions of Windows)
  
Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...

Ini2Reg 指令引用的每个命名部分的形式如下:

[ini-to-registry-section]
 
ini-file,ini-section,[ini-key],reg-root,subkey[,flags]
...

一个 ini-to-registry-section 可以有任意数量的 INF 编写器确定的条目,并且每个条目都在单独一行中。

条目

ini-file
指定源介质上提供的 INI 文件的名称。 此值可以用 filename 表示,也可以用 %strkey% 标记表示,该标记在 INF 文件的 Strings 部分中定义。

ini-section
指定给定 INI 文件中包含要复制的注册表信息的部分名称。

ini-key
指定要复制到注册表的 INI 文件中的项名称。 如果省略此值,整个 ini-section 将被转移到指定的注册表 subkey 中。

reg-root
为此条目中提供的其他值标识注册表树的根。 有关具体内容,请参阅 AddReg 指令的引用。

subkey
标识要接收值的子键,可以是 INF Strings 部分中定义的 %strkey% 标记,也可以是给定 reg-root 中的明确注册表路径 (key1\key2\key3...)。

flags
指定(在位 0)将给定信息传输到注册表后如何处理 INI 文件和/或(在位 1)是否覆盖现有注册表信息,如下所示:

Bit zero = 0
将 INI 文件复制到注册表后,不要删除其中的给定信息。 这是默认情况。

Bit zero = 1
将 INI 文件中的给定信息移入注册表后将其删除。

Bit one = 0
如果指定的子项已存在于注册表中,则不要将 INI 提供的信息转入该 subkey 中。 否则,将在注册表中创建指定的 subkey,并将 INI 提供的信息作为其值项。 这是默认情况。

Bit one = 1
如果指定的子项已存在于注册表中,则用 INI 提供的信息替换其值项。

注解

Ini2Reg 指令在正式语法声明所示的任何部分中都有效。 此指令在由 AddInterface 指令引用或在 InterfaceInstall32 部分引用的 INF 编写器定义的部分中也有效。

如果 INF 文件用于在 Windows XP 及更高版本的 Windows 上安装设备,则 INF 文件不应包含 Ini2Reg 指令。 包含 Ini2Reg 指令的 INF 文件将无法通过“为 Windows 而设计”徽标测试,也不会获得数字签名,因此不会被 Windows 信任(请参阅 Windows 如何选择驱动程序)。

每个 ini-to-registry-section 名称在 INF 文件中都必须是唯一的。 每个 INF-writer-created 部分名称在 INF 文件中都必须唯一,并且必须遵循定义部分名称的一般规则。 有关这些规则的详细信息,请参阅 INF 文件的常规语法规则

INF 以下列方式之一提供给定 ini-file 在分发介质上的完整路径:

  • 在 IHV/OEM 提供的 INF 文件中,使用该 INF 的 SourceDisksNames 部分(可能还有 SourceDisksFiles 部分),显式指定不在分发介质根目录(或多个目录)中的每个已命名源文件的完整路径。

  • 在系统提供的 INF 文件中,提供一个或多个附加 INF 文件,这些文件在 INF 文件 Version 部分的 LayoutFile 条目中标识。

另请参阅

AddInterface

AddReg

ClassInstall32

DDInstall

InterfaceInstall32

SourceDisksFiles

SourceDisksNames

字符串

UpdateIniFields

UpdateInis

版本