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 UpdateInis refere-se a uma ou mais secções nomeadas, especificando um ficheiro INI a partir do qual uma determinada secção ou linha deve ser lida e aplicada a um ficheiro INI existente com o mesmo nome no computador alvo. Opcionalmente, modificações linha a linha de e para tais ficheiros INI podem ser especificadas na secção update-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)
UpdateInis=update-ini-section[,update-ini-section]...
Esta diretiva quase nunca é especificada em ficheiros INF para instalação no Windows, devido à falta de necessidade de ficheiros INI. No entanto, a diretiva UpdateInis é válida em qualquer uma das secções apresentadas na declaração formal de sintaxe, bem como nas secções definidas pelo escritor INF referenciadas por uma diretiva AddInterface ou referenciadas numa secção InterfaceInstall32 .
Cada secção nomeada referenciada por uma diretiva UpdateInis tem a seguinte forma:
[update-ini-section]
ini-file,ini-section[,old-ini-entry][,new-ini-entry][,flags]
...
Uma secção update-ini pode ter qualquer número determinado pelo INF-writer de entradas, cada uma numa linha separada.
Entradas
ini-file
Especifica o nome de um ficheiro INI fornecido no meio de origem e, implicitamente, o do ficheiro INI a ser atualizado no 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 do ficheiro INI indicado. Se os dois valores seguintes forem especificados, esta secção contém uma entrada a ser alterada. Se uma entrada antiga-ini for omitida mas for fornecida uma entrada nova-ini , a nova entrada deve ser adicionada à medida que esta secção for lida.
entrada antiga-ini-
Este valor opcional especifica o nome de uma entrada na secção ini dada, normalmente expresso na seguinte forma:
"key=value"
Qualquer um ou ambos de chave e valor podem ser expressos como %strkey% tokens definidos numa secção Strings do ficheiro INF. O asterisco (*) pode ser especificado como um curinga para a chave ou para o valor.
Entrada nova-ini-
Este valor opcional especifica ou uma alteração a uma dada entrada antiga-ini ou a adição de uma nova entrada. Este valor pode ser expresso da mesma forma que old-ini-entry.
flags
Este valor opcional controla a interpretação da entrada antiga-ini-e /ou nova-ini-entrada. A entrada das bandeiras pode ser um dos seguintes valores numéricos:
| Valor | Meaning |
|---|---|
| 0 | Este é o valor padrão para a entrada de flags se for omitida. Se a chave de entrada antiga-ini dada estiver presente nos ficheiros INI, substitua-se essa chave=valor pela entrada-ini-nova dada. Apenas as chaves nos ficheiros INI têm de coincidir. O valor correspondente de cada uma dessas chaves é ignorado. Para adicionar incondicionalmente uma entrada new-ini ao ficheiro INI de destino, omita o valor old-ini-entry da entrada na secção update-ini do INF. Para eliminar incondicionalmente uma entrada antiga-ini do ficheiro INI de destino, omita o valor da entrada new-ini . |
| 1 | Se a entrada antiga-ini-dada (chave=valor) existir nos ficheiros INI, substitua-a no ficheiro INI de destino que tem a nova entrada ini-dada. Tanto a chave como o valor da entrada antiga-ini especificada devem corresponder aos dos ficheiros INI para que tal substituição seja feita, não apenas as suas chaves como para o valor das bandeiras anteriores. |
| 2 | Se a chave especificada para old-ini-entry não for encontrada no ficheiro INI de destino, não faça nada. Caso contrário, as alterações feitas dependem das correspondências encontradas nos ficheiros INI para as chaves dadas de entrada-ini-antiga e entrada-ini-nova, da seguinte forma: (1) Se a chave da entrada antiga-ini existir nos ficheiros INI mas também existe a chave da entrada new-ini, substituir a entrada old-ini pela entrada new-ini no ficheiro INI de destino e, depois, remover a entrada superflua new-ini desse ficheiro INI. (2) Se a chave da entrada ini-antiga existir nos ficheiros INI mas a chave da entrada ini-nova não, substitua-se a chave da entrada ini-antiga pela da entrada ini-nova no ficheiro INI de destino, mas mantendo o valor da entrada ini-antiga inalterado. |
| 3 | Se a chave e o valor especificados para a entrada antiga-ini não forem encontrados nos ficheiros INI, não faça nada. Caso contrário, as alterações feitas dependem das correspondências encontradas nos ficheiros INI para as chaves e valores dados de entrada-ini-antiga e entrada-ini-nova, da seguinte forma: (1) Se a chave=valor da entrada antiga-ini existe nos ficheiros INI mas também existe a chave=valor da entrada-nova-ini, substitua-se a entrada-ini-antiga pela entrada-nova-ini-na no ficheiro INI de destino e, depois, remova-se a entrada supérflua-ini-nova desse ficheiro INI. (2) Se a chave=valor da entrada ini-antiga existir nos ficheiros INI mas a entrada ini-nova não, substitua-se a entrada ini-antiga pela entrada ini-nova no ficheiro INI de destino, mas mantendo o valor da entrada ini-antiga inalterado. |
Remarks
Um dado nome de secção update-ini-section 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.
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.
Qualquer nome de ficheiro especificado dentro de uma entrada antiga-ini ou nova-ini-entrada deve designar o diretório de destino que contém esse ficheiro. Tal caminho de diretório de destino de um nome de ficheiro numa entrada de secção update-ini deve ser especificado como um dirid. Para listas de possíveis valores de dirid , veja Usar Dirids.