Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Caution
A partir do Windows 11 versão 22H2, um pacote de drivers que utilize esta diretiva deixa de ser elegível para assinatura do Hardware Developer Center.
Os pacotes universais de drivers e os drivers do Windows não podem usar esta diretiva.
Uma diretiva UpdateIniFields refere-se a uma ou mais secções nomeadas nas quais podem ser especificadas modificações detalhadas dentro das linhas de um ficheiro 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 secção nomeada referenciada por uma diretiva UpdateIniFields tem a seguinte forma:
[update-inifields-section]
ini-file,ini-section,profile-name[,old-field][,new-field][,flags]
...
Uma secção update-inifields-pode ter qualquer número determinado pelo escritor INF, cada uma numa linha separada.
Entradas
ini-file
Especifica o nome de um ficheiro INI fornecido no suporte de origem e, implicitamente, o de um ficheiro INI atualizado to-beno computador de destino. Este valor pode ser expresso como um nome de ficheiro ou como um %strkey% token definido numa secção Strings do ficheiro INF.
Ini-Section
Especifica o nome da secção dentro dos ficheiros INI dados que contém a linha a ser modificada.
Nome do perfil
Especifica o nome da linha a ser modificada dentro da secção INI dada. Pelo menos uma das entradas de campo antigo e/ou campo novo deve ser especificada para efetuar uma modificação desta linha.
Campo Antigo
Especifica um campo existente dentro da linha dada. Se o campo novo for omitido desta entrada de secção, este campo é eliminado da linha indicada. Caso contrário, o valor do novo campo dado deve substituir este campo.
Novo campo
Especifica uma substituição para um campo antigo dado ou, se campo antigo for omitido, uma adição à linha dada.
flags
Especifica (no bit 0) como interpretar umdado campoantigo- e/ou novo-campo se um ou ambos contêm um asterisco (*), e/ou (no bit 1) qual o carácter separador a usar ao adicionar um dado novo campo à linha dada, da seguinte forma:
Bit zero = 0
Interprete qualquer asterisco (*) nas entradas especificadas de campo antigo e/ou campo novo literalmente, não como um carácter coringa, ao procurar uma correspondência na linha dada do ficheiro INI. Este é o valor padrão.
Bit zero = 1
Interprete qualquer asterisco (*) nas entradas especificadas no campo antigo e/ou novo campo como um carácter coringa ao procurar uma correspondência na linha dada do ficheiro INI.
Bit um = 0
Use um carácter de espaço como separador ao adicionar a entrada de campo novo especificada à linha dada do ficheiro INI. Este é o valor padrão.
Bit um = 1
Use uma vírgula (,) como separador ao adicionar a entrada de novo campo especificada à linha dada do ficheiro INI.
Remarks
A diretiva UpdateIniFields quase nunca é especificada em ficheiros INF para instalações no Windows porque não é necessário ter ficheiros INI nos seus suportes de distribuição. No entanto, a diretiva UpdateIniFields é válida em qualquer uma das secções apresentadas na declaração de sintaxe formal, bem como em secções definidas por INF-writer referenciadas por uma diretiva AddInterface ou referenciadas numa secção InterfaceInstall32 .
Cada nome de secção de update-inifields-deve ser único para o ficheiro INF. Cada nome de secção criado pelo escritor INF deve ser único dentro do ficheiro INF e deve seguir as regras gerais para definir nomes de secção. Para mais informações sobre estas regras, consulte Regras Gerais de Sintaxe para Ficheiros INF.
Ao contrário de uma secção referenciada pela diretiva UpdateInis , uma secção referenciada por UpdateIniFields substitui, adiciona ou elimina partes de uma linha numa linha de ficheiro INI existente em vez de afetar o valor total de uma determinada linha. Pelo menos um dos valores de campo antigo e/ou campo novo deve ser especificado em cada entrada de secção.
Quaisquer comentários numa linha de ficheiro INI to-bemodificada são removidos porque podem não ser aplicáveis após alterações feitas de acordo com esta secção. Ao procurar campos na linha nos ficheiros INI, espaços, tabulações e vírgulas são interpretados como delimitadores de campo. No entanto, um carácter de espaço é usado como separador predefinido quando um novo campo é adicionado a uma linha.
O INF fornece o caminho completo do ficheiro ini dado no meio de distribuição de uma das seguintes formas:
Em ficheiros INF fornecidos por IHV/OEM, utilizando as secções SourceDisksNames e SourceDisksFiles deste INF para especificar explicitamente o caminho completo de cada ficheiro fonte nomeado que não está no diretório raiz (ou diretórios) no meio de distribuição.
Nos ficheiros INF fornecidos pelo sistema, fornecendo um ou mais ficheiros INF adicionais, identificados na entrada LayoutFile na secção Version do ficheiro INF.