Директива INF Ini2Reg

Статья
07/17/2023

Внимание!

Начиная с 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-writer, каждая из которых размещена в отдельной строке.

Записи

ini-file
Указывает имя INI-файла, предоставленного на исходном носителе. Это значение может быть выражено в виде имени файла или маркера %strkey%, определенного в разделе Strings INF-файла.

ini-section
Указывает имя раздела в заданном INI-файле, который содержит копируемые сведения о реестре.

ini-key
Указывает имя раздела в INI-файле для копирования в реестр. Если это значение не указано, весь ini-section должен быть передан в указанный подраздел реестра.

reg-root
Определяет корень дерева реестра для других значений, указанных в этой записи. Подробные сведения см. в справочнике по директиве AddReg.

Подраздел
Определяет подраздел для получения значения, выраженного в виде токена %strkey%, определенного в разделе Strings INF, или в виде явного пути реестра (key1\key2\key3...) из заданного корня реестра.

flags
Указывает (в бите 0) способ обработки INI-файла после передачи заданной информации в реестр и /или (в бите 1) перезаписи существующих сведений реестра следующим образом:

Бит ноль = 0
Не удаляйте указанные сведения из INI-файла после их копирования в реестр. Это значение по умолчанию.

Бит ноль = 1
Удалите указанные сведения из INI-файла после их перемещения в реестр.

Бит 1 = 0
Если указанный подраздел уже существует в реестре, не передавайте предоставленные INI сведения в этот подраздел. В противном случае создайте указанный подраздел в реестре с данными, предоставленными INI, в качестве значения. Это значение по умолчанию.

Бит 1 = 1
Если указанный подраздел уже существует в реестре, замените его запись значения данными, предоставленными INI.

Директива Ini2Reg допустима в любом из разделов, показанных в формальной синтаксической инструкции. Эта директива также действительна в разделах, определенных inf-writer, на которые ссылается директива AddInterface , или в разделе InterfaceInstall32 .

Если INF-файл используется для установки устройств в Windows XP и более поздних версиях Windows, INF-файл не должен содержать директивы Ini2Reg . INF-файлы, содержащие директивы Ini2Reg , не будут проходить проверку логотипа "Разработано для Windows", не получат цифровую подпись и, следовательно, не будут доверенными для Windows (см. раздел Выбор драйверов в Windows).

Каждое имя раздела ini-to-registry должно быть уникальным для INF-файла . Каждое имя раздела, созданного inf-writer, должно быть уникальным в ПРЕДЕЛАХ INF-файла и соответствовать общим правилам определения имен разделов. Дополнительные сведения об этих правилах см. в разделе Общие правила синтаксиса для ФАЙЛОВ INF.

Inf предоставляет полный путь к заданному ini-файлу на носителе распространения одним из следующих способов:

В INF-файлах, предоставленных IHV или OEM, с помощью разделов SourceDisksNames и, возможно, SourceDisksFiles этого inf, чтобы явно указать полный путь к каждому именованному исходному файлу, который не находится в корневом каталоге (или каталогах) на носителе распространения.
В системных INF-файлах, указав один или несколько дополнительных INF-файлов, указанных в записи LayoutFile в разделе Версия INF-файла.