Diretiva RenFiles do INF

  • Artigo

Cuidado

Se você estiver criando um pacote universal ou do Driver do Windows, essa diretiva não será válida. Consulte Usando um arquivo INF universal e Introdução com drivers do Windows.

Uma diretiva RenFiles faz referência a uma seção definida pelo gravador INF em outro lugar no arquivo INF, o que faz com que essa lista de arquivos seja renomeada no contexto de operações na seção na qual a diretiva RenFiles de referência é 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)

Renfiles=file-list-section[,file-list-section]...

Uma diretiva RenFiles pode ser especificada em qualquer uma das seções mostradas na instrução de sintaxe formal. Essa diretiva também pode ser especificada em qualquer uma das seguintes seções definidas pelo gravador INF:

Cada seção nomeada referenciada por uma diretiva RenFiles tem uma ou mais entradas do seguinte formulário:

[file-list-section]
 
new-dest-file-name,old-source-file-name 
...

Uma seção de lista de arquivos pode ter qualquer número de entradas, cada uma em uma linha separada.

Entradas

new-dest-file-name
Especifica o novo nome a ser dado ao arquivo no destino.

old-source-file-name
Especifica o nome antigo do arquivo.

Comentários

Importante

Essa diretiva deve ser usada com cuidado. É altamente recomendável que você não use a diretiva RenFiles no arquivo INF para um driver de função de Plug and Play (PnP).

Qualquer nome de seção de lista de arquivos deve ser exclusivo para o arquivo INF, mas pode ser referenciado pelas diretivas CopyFiles, DelFiles ou RenFiles em outro lugar no mesmo INF. Esse nome de seção definido pelo gravador INF 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.

A diretiva RenFiles não dá suporte à decoração de um nome de seção de lista de arquivos com uma extensão de plataforma definida pelo sistema (.nt, .ntx86, .ntia64, .ntamd64, .ntarm ou .ntarm64).

A seção DestinationDirs do arquivo INF controla o destino de todas as operações de renomeação de arquivo, independentemente da seção que contém uma diretiva RenFiles específica. As regras a seguir descrevem a operação de renomeação de arquivo:

  • Se uma seção nomeada referenciada por uma diretiva RenFiles tiver uma entrada correspondente na seção DestinationDirs no mesmo INF, essa entrada especificará explicitamente o diretório de destino. Todos os arquivos listados na seção nomeada são renomeados no destino antes que esses arquivos de origem sejam copiados.

  • Se uma seção nomeada não estiver listada na seção DestinationDirs , o Windows usará a entrada DefaultDestDir na seção DestinationDirs do INF.

Observação

Você não pode usar um token %strkey% para especificar os nomes de arquivo novos ou antigos. Para obter mais informações sobre %strkey% tokens, consulte Seção Cadeias de caracteres INF.

Exemplos

Este exemplo mostra uma seção referenciada por uma diretiva RenFiles .

[RenameOldFilesSec]
devfile41.sav, devfile41.sys

Confira também

Addinterface

ClassInstall32

CopyFiles

DDInstall

DelFiles

DestinationDirs

InterfaceInstall32

SourceDisksFiles

SourceDisksNames

Strings

Versão