Директива 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 может быть любое количество записей, определяемых inf-writer, каждое из которых выполняется в отдельной строке.
Операции
ini-file
Указывает имя ФАЙЛА INI, предоставленного на исходном носителе. Это значение может быть выражено как имя файла или как маркер %strkey% , определенный в разделе Strings в INF-файле.
ini-section
Указывает имя раздела в указанном ФАЙЛЕ INI, который содержит сведения о реестре, которые нужно скопировать.
ini-key
Указывает имя ключа в INI-файле, который необходимо скопировать в реестр. Если это значение не указано, весь раздел ini-section должен быть передан в указанный подраздел реестра.
reg-root
Определяет корневой каталог дерева реестра для других значений, указанных в этой записи. Дополнительные сведения см. в справочнике по директиве AddReg.
вложенный ключ
Идентифицирует вложенный ключ для получения значения, выраженный как маркер %strkey%, определенный в разделе СТРОК INF или как явный путь к реестру (key1\key2\key3...) из заданного корневого каталога reg-root.
flags
Указывает (в бите 0) как обрабатывать INI-файл после передачи указанной информации в реестр и (или) (в бите 1), следует ли перезаписать существующие сведения реестра следующим образом:
Бит нуля = 0
Не удаляйте указанные сведения из INI-файла после копирования его в реестр. Это значение по умолчанию.
Бит нуля = 1
Удалите указанные сведения из INI-файла после его перемещения в реестр.
Bit one = 0
Если указанный подраздел уже существует в реестре, не передайте предоставленные INI сведения в этот подраздел. В противном случае создайте указанный подраздел в реестре с указанными сведениями INI в качестве записи значения. Это значение по умолчанию.
Bit one = 1
Если указанный подраздел уже существует в реестре, замените его запись значения сведениями, предоставленными INI.
Замечания
Директива Ini2Reg действительна в любом из разделов, показанных в формальной инструкции синтаксиса. Эта директива также допустима в разделах, определенных inf-writer, на которые ссылается директива AddInterface или указанная в разделе InterfaceInstall32.
Если INF-файл используется для установки устройств в Windows XP и более поздних версиях Windows, INF-файл не должен содержать директивы Ini2Reg . INF-файлы, содержащие директивы Ini2Reg , не будут передавать проверку логотипа "Разработанный для Windows", не получат цифровую подпись и поэтому не будут доверять Windows (см. раздел "Выбор драйверов Windows").
Каждое имя раздела ini-to-registry должно быть уникальным для INF-файла. Каждое имя раздела, созданного в INF-записи, должно быть уникальным в INF-файле и должно соответствовать общим правилам определения имен разделов. Дополнительные сведения об этих правилах см. в разделе Общие правила синтаксиса для INF-файлов.
INF предоставляет полный путь к указанному ini-file на носителе распространения одним из следующих способов:
В IHV/OEM-файлах INF с помощью sourceDisksNames и, возможно, разделов SourceDisksFiles этого INF, чтобы явно указать полный путь к каждому именованному исходному файлу, который не находится в корневом каталоге (или каталогах) на носителе распространения.
В системных INF-файлах, указав один или несколько дополнительных INF-файлов, указанных в записи LayoutFile в разделе "Версия " INF-файла.