Diretiva UPDATEIniFields do INF

Artigo
02/02/2024

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 do Centro de Desenvolvedores de Hardware.

Pacotes de driver universais e Drivers do Windows não podem usar essa diretiva.

Uma diretiva UpdateIniFields faz referência a uma ou mais seções nomeadas nas quais modificações refinadas dentro das linhas de um arquivo INI podem ser especificadas.

[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 seção update-inifields pode ter qualquer número de entradas determinadas 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 e, implicitamente, o 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 campo antigo e/ou de novo campo deve ser especificada para efetuar uma modificação dessa linha.

campo antigo
Especifica um campo existente dentro da linha fornecida. Se new-field for omitido desta entrada de seção, esse campo será excluído da linha fornecida. Caso contrário, o valor de novo campo fornecido deve substituir esse campo.

new-field
Especifica uma substituição para um determinado campo antigo ou, se o campo antigo for omitido, uma adição à linha fornecida.

sinalizadores
Especifica (no bit 0) como interpretar determinadocampoantigo- e/ou novo-campo se ou ambos contiverem um asterisco (*) e/ou (no bit 1) que o caractere separador usar ao acrescentar um determinado novo campo à linha determinada, da seguinte maneira:

Bit zero = 0
Interprete qualquer asterisco (*) nas entradas de campo antigo e/ou new-field especificadas literalmente, não como um caractere de cartão selvagem, ao pesquisar uma correspondência na linha especificada do arquivo INI. Esse é o valor padrão.

Bit zero = 1
Interprete qualquer asterisco (*) nas entradas de campo antigo e/ou novo especificado como um caractere de cartão selvagem ao pesquisar 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 novo campo especificada à linha especificada do arquivo INI. Esse é o valor padrão.

Bit um = 1
Use uma vírgula (,) como separador ao adicionar a entrada de novo campo especificada à linha especificada 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 suas mídias 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 nas seções definidas pelo gravador INF referenciadas por uma diretiva AddInterface ou referenciadas em uma seção InterfaceInstall32 .

Cada nome update-inifields-section deve ser exclusivo para o arquivo INF. Cada nome de seção criado pelo inf-writer 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 de sintaxe geral 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 de campo antigo e/ou novo-campo deve ser especificado em cada entrada de seção.

Todos os 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, guias 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 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 SourceDisksFiles 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ção Versão do arquivo INF.