Diretiva INF RenFiles
Cuidado
Se você estiver criando um pacote de drivers universal ou do Windows, essa diretiva não será válida. Consulte Usar um arquivo INF universal e Introdução ao desenvolvimento de drivers do Windows.
Uma diretiva RenFiles faz referência a uma seção INF-writer-defined em outro lugar no arquivo INF, que faz com que essa lista de arquivos seja renomeada no contexto de operações na seção em que a diretiva RenFiles referenciada seja 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 do INF:
- Uma add-interface-section referenciada pela diretiva AddInterface em uma seção DDInstall.Interfaces.
- Uma install-interface-section referenciada em uma seção InterfaceInstall32.
Cada seção nomeada referenciada por uma diretiva RenFiles tem uma ou mais entradas do seguinte formato:
[file-list-section]
new-dest-file-name,old-source-file-name
...
Uma file-list-section 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
Esta diretiva deve ser utilizada com cuidado. É altamente recomendável que você não use a diretiva RenFiles no arquivo INF para um driver de função Plug and Play (PnP).
Qualquer nome de file-list-section deve ser exclusivo para o arquivo INF, mas pode ser referenciado pelas diretivas CopyFiles, DelFiles ou RenFiles em outro lugar no mesmo INF. Tal seção INF-writer-defined 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.
A diretiva RenFiles não dá suporte à decoração de um nome de file-list-section 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 file-rename, independentemente da seção que contém uma diretiva RenFiles específica. As regras a seguir descrevem a operação file-rename:
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 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 mais informações sobre tokens %strkey%, consulte a seção Strings do INF.
Exemplos
Este exemplo mostra uma seção referenciada por uma diretiva RenFiles.
[RenameOldFilesSec]
devfile41.sav, devfile41.sys