Diretiva INF UpdateIniFields
Cuidado
A partir do Windows 11 versão 22H2, um pacote de driver que usa essa diretiva não está mais qualificado para uma assinatura da Central do Desenvolvedor para Hardware.
Os pacotes de driver Universais e os Drivers do Windows não podem usar essa diretiva.
Uma diretiva UpdateIniFields faz referência a uma ou mais seções nomeadas nas quais podem ser especificadas modificações detalhadas nas linhas de um arquivo 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)
UpdateIniFields=update-inifields-section[,update-inifields-section]...
Cada seção nomeada referenciada por uma diretiva UpdateIniFields tem o seguinte formato:
[update-inifields-section]
ini-file,ini-section,profile-name[,old-field][,new-field][,flags]
...
Uma update-inifields-section pode ter qualquer número de entradas INF-writer-determined, cada uma em uma linha separada.
Entradas
ini-file
Especifica o nome de um arquivo INI fornecido na mídia de origem e, implicitamente, aquele de um arquivo INI a ser atualizado no computador de destino. 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 dos arquivos INI fornecidos que contém a linha a ser modificada.
profile-name
Especifica o nome da linha a ser modificada dentro da seção INI fornecida. Pelo menos uma das entradas de old-field e/ou new-field deve ser especificada para efetuar uma modificação desta linha.
old-field
Especifica um campo existente na linha fornecida. Se new-field for omitido desta entrada de seção, este campo será excluído da linha fornecida. Caso contrário, o valor de new-field fornecido deve substituir este campo.
new-field
Especifica uma substituição para um determinado old-field ou se old-field for omitido, uma adição à linha fornecida.
sinalizadores
Especifica (no bit 0) como interpretar determinado campo-antigo e/ou campo-novo se um ou ambos contiverem um asterisco (*) e/ou (no bit 1) qual caractere separador usar ao anexar um determinado new-field à linha fornecida, da seguinte forma:
Bit zero = 0
Interprete qualquer asterisco (*) nas entradas de campo old-field e/ou new-field literalmente, não como um caractere curinga, ao procurar uma correspondência na linha especificada do arquivo INI. Este é o valor padrão.
Bit zero = 1
Interprete qualquer asterisco (*) nas entradas de campo old-field e/ou new-field literalmente, não como um caractere curinga, ao procurar uma correspondência na linha especificada do arquivo INI.
Bit um = 0
Use um caractere de espaço como separador ao adicionar a entrada de new-field à linha fornecida do arquivo INI. Este é o valor padrão.
Bit um = 1
Use uma vírgula (,) como separador ao adicionar a entrada especificada de new-field à linha fornecida do arquivo INI.
Comentários
A diretiva UpdateIniFields quase nunca é especificada em arquivos INF para instalações no Windows porque não é necessário ter arquivos INI em sua mídia de distribuição. No entanto, a diretiva UpdateIniFields é válida em qualquer uma das seções mostradas na instrução de sintaxe formal, bem como em seções definidas pelo gravador INF referenciadas por uma diretiva AddInterface ou referenciada na seção InterfaceInstall32.
Cada nome update-inifields-section deve ser exclusivo para o arquivo INF. Cada nome de seção INF-writer-created deve ser exclusivo dentro do arquivo INF e deve seguir as regras gerais para definir nomes de seção. Para mais informações sobre essas regras, consulte Regras gerais de sintaxe para arquivos INF.
Ao contrário de uma seção referenciada pela diretiva UpdateInis, uma seção referenciada por UpdateIniFields substitui, adiciona ou exclui partes de uma linha em uma linha de arquivo INI existente em vez de afetar todo o valor de uma linha específica. Pelo menos um dos valores old-field e/ou new-field deve ser especificado em cada entrada de seção.
Quaisquer comentários em uma linha de arquivo INI a ser modificada são removidos porque podem não ser aplicáveis após as alterações feitas de acordo com esta seção. Ao procurar campos na linha nos arquivos INI, espaços, tabulações e vírgulas são interpretados como delimitadores de campo. No entanto, um caractere de espaço é usado como separador padrão quando um novo campo é acrescentado a uma linha.
O INF fornece o caminho completo do ini-file na mídia de distribuição de uma das seguintes maneiras:
Em arquivos INF fornecidos por IHV/OEM, usando as seções SourceDisksNames e 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 Version do arquivo INF.