Diretiva INF Ini2Reg

Artigo
07/20/2023

Cuidado

A partir Windows 11 versão 22H2, um pacote de driver que usa essa diretiva não está mais qualificado para uma assinatura do Centro de Desenvolvedores de Hardware.

Os pacotes de driver universais e os Drivers do Windows não podem usar essa diretiva.

Uma diretiva Ini2Reg faz referência a uma ou mais seções nomeadas nas quais linhas ou seções de um arquivo INI fornecido são movidas para o registro. Isso cria ou substitui uma ou mais entradas de valor em uma chave especificada.

[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]...

Cada seção nomeada referenciada por uma diretiva Ini2Reg tem o seguinte formulário:

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

Uma seção ini-to-registry pode ter qualquer número de entradas determinado pelo gravador INF, cada uma em uma linha separada.

Entradas

ini-file
Especifica o nome de um arquivo INI fornecido na mídia de origem. Esse valor pode ser expresso como um nome de arquivo ou como um token %strkey% definido em uma seção Strings do arquivo INF.

ini-section
Especifica o nome da seção dentro do arquivo INI fornecido que contém as informações do Registro a serem copiadas.

ini-key
Especifica o nome da chave no arquivo INI a ser copiado para o registro. Se esse valor for omitido, toda a seção ini será transferida para a subchave do Registro especificada.

reg-root
Identifica a raiz da árvore do Registro para outros valores fornecidos nesta entrada. Para obter detalhes, consulte a referência para a diretiva AddReg.

subkey
Identifica a subchave para receber o valor, expressa como um token %strkey% definido em uma seção Strings do INF ou como um caminho de registro explícito (key1\key2\key3...) da raiz reg fornecida.

sinalizadores
Especifica (no bit 0) como manipular o arquivo INI depois de transferir as informações fornecidas para o registro e/ou (no bit 1) se deseja substituir as informações existentes do Registro, da seguinte maneira:

Bit zero = 0
Não remova as informações fornecidas do arquivo INI depois de copiá-la para o registro. Esse é o padrão.

Bit zero = 1
Exclua as informações fornecidas do arquivo INI depois de movê-la para o registro.

Bit um = 0
Se a subchave especificada já existir no registro, não transfira as informações fornecidas por INI para essa subchave. Caso contrário, crie a subchave especificada no registro com essas informações fornecidas por INI como sua entrada de valor. Esse é o padrão.

Bit um = 1
Se a subchave especificada já existir no registro, substitua sua entrada de valor pelas informações fornecidas por INI.

Comentários

A diretiva Ini2Reg é válida em qualquer uma das seções mostradas na instrução de sintaxe formal. Essa diretiva também é válida em seções definidas pelo gravador INF referenciadas por uma diretiva AddInterface ou referenciadas em uma seção InterfaceInstall32 .

Se um arquivo INF for usado para instalar dispositivos no Windows XP e versões posteriores do Windows, o arquivo INF não deverá conter diretivas Ini2Reg . Os arquivos INF que contêm diretivas Ini2Reg não passarão no teste do logotipo "Projetado para Windows", não receberão uma assinatura digital e, portanto, não serão confiáveis pelo Windows (confira Como o Windows seleciona drivers).

Cada nome ini-to-registry-section deve ser exclusivo para o arquivo INF. Cada nome de seção criado pelo GRAVADOR INF deve ser exclusivo no arquivo INF e deve seguir as regras gerais para definir nomes de seção. Para obter mais informações sobre essas regras, consulte Regras gerais de sintaxe para arquivos INF.

O INF fornece o caminho completo do arquivo ini fornecido na mídia de distribuição de uma das seguintes maneiras:

Em arquivos INF fornecidos por IHV/OEM, usando as seções SourceDisksNames e, possivelmente, SourceDisksFiles desse INF para especificar explicitamente o caminho completo de cada arquivo de origem nomeado que não está no diretório raiz (ou diretórios) na mídia de distribuição.
Em arquivos INF fornecidos pelo sistema, fornecendo um ou mais arquivos INF adicionais, identificados na entrada LayoutFile na seção Versão do arquivo INF.