Diretiva INF Ini2Reg
Atenção
A partir da versão 22H2 do Windows 11, um pacote de driver de usando essa diretiva não é mais elegível para uma assinatura do Hardware Developer Center.
Pacotes de drivers universais e Drivers do Windows não podem usar esta 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 sob 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 a seguinte forma:
[ini-to-registry-section]
ini-file,ini-section,[ini-key],reg-root,subkey[,flags]
...
Um de seção ini para registro de pode ter qualquer número de entradas determinado pelo gravador INF, cada uma em uma linha separada.
Inscrições
ini-file
Especifica o nome de um arquivo INI fornecido na mídia de origem. Esse valor pode ser expresso como um de nome de arquivo ou como um token de% strkey %definido em uma seçãoStringsdo arquivo INF.
da secção inicial
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 de ini-section será transferida para a subchave de de registro especificada.
reg-root
Identifica a raiz da árvore do Registro para outros valores fornecidos nesta entrada. Para obter informações específicas, consulte a referência para a diretiva AddReg.
subchave
Identifica a subchave para receber o valor, expressa como um token de% strkey %definido em uma seção Strings do INF ou como um caminho de registro explícito (key1\key2\key3...) do reg-root defornecido.
bandeiras
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 as informações do Registro existentes devem ser substituídas, da seguinte maneira:
Bit zero = 0
Não remova as informações fornecidas do arquivo INI depois de copiá-lo para o registro. Este é o padrão.
Bit zero = 1
Exclua as informações fornecidas do arquivo INI depois de movê-lo para o registro.
Bit um = 0
Se a subchave especificada já existir no registo, não transfira as informações fornecidas pelo INI para esta subchave . Caso contrário, crie a de subchave especificada no Registro com essas informações fornecidas pelo INI como sua entrada de valor. Este é o padrão.
Bit um = 1
Se a subchave especificada já existir no Registro, substitua sua entrada de valor pelas informações fornecidas pelo INI.
Comentários
A diretiva Ini2Reg é válida em qualquer uma das seções mostradas na declaração de sintaxe formal. Essa diretiva também é válida em seções definidas pelo gravador INF referenciadas por uma diretivaAddInterfaceou referenciadas em uma seçãoInterfaceInstall32.
Se um arquivo INF é usado para instalar dispositivos no Windows XP e versões posteriores do Windows, o arquivo INF não deve conter diretivas de Ini2Reg. Os arquivos INF que contêm diretivas Ini2Reg não passarão no teste do logotipo "Designed For Windows", não receberão uma assinatura digital e, portanto, não serão confiáveis pelo Windows (consulte 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 INF deve ser exclusivo dentro do 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 de arquivo ini de determinado na mídia de distribuição de uma das seguintes maneiras:
Em arquivos INF fornecidos por IHV/OEM, usando o SourceDisksNames e, possivelmente, SourceDisksFiles seções deste 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çãoVersãodo arquivo INF.