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
Se estiver a construir um pacote universal ou de drivers para Windows, esta diretiva não é válida. Veja Usar um Ficheiro INF Universal e comece a desenvolver drivers para Windows.
Uma diretiva RenFiles refere-se a uma secção definida pelo autor INF noutra parte do ficheiro INF, o que faz com que essa lista de ficheiros seja renomeada no contexto das operações na secção em que a diretiva RenFiles referente é 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 secções apresentadas na declaração de sintaxe formal. Esta diretiva pode também ser especificada em qualquer uma das seguintes secções definidas pelo autor do INF:
- Uma secção de interface adicional referenciada pela diretiva AddInterface numa secção DDInstall. Interfaces .
- Uma secção de interface de instalação referenciada numa secção InterfaceInstall32 .
Cada secçã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 secção de lista de ficheiros pode ter qualquer número de entradas, cada uma numa linha separada.
Entradas
New-dest-filename-de-ficheiro
Especifica o novo nome a ser atribuído ao ficheiro no destino.
nome do ficheiro-fonte-antigo
Especifica o nome antigo do ficheiro.
Remarks
Important
Esta diretiva deve ser usada com cuidado. Recomendamos vivamente que não utilize a diretiva RenFiles no ficheiro INF para um controlador de funções Plug and Play (PnP).
Qualquer nome de secção de lista de ficheiros deve ser único para o ficheiro INF, mas pode ser referenciado por diretivas CopyFiles, DelFiles ou RenFiles noutros locais do mesmo INF. Tal nome de secção definido pelo autor INF 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.
A diretiva RenFiles não suporta decorar o nome de uma secção de lista de ficheiros com uma extensão de plataforma definida pelo sistema (.nt, .ntx86, .ntia64, .ntamd64, .ntarm ou .ntarm64).
A secção DestinationDirs do ficheiro INF controla o destino para todas as operações de renomeação de ficheiros, independentemente da secção que contenha uma diretiva RenFiles específica. As seguintes regras descrevem a operação de renomeação de ficheiros:
Se uma secção nomeada referenciada por uma diretiva RenFiles tiver uma entrada correspondente na secção DestinationDirs no mesmo INF, essa entrada especifica explicitamente o diretório de destino. Todos os ficheiros listados na secção nomeada são renomeados no destino antes de esses ficheiros fonte serem copiados.
Se uma secção nomeada não estiver listada na secção DestinationDirs, o Windows utiliza a entrada DefaultDestDir na secção DestinationDirs do INF.
Note
Não podes usar um token% strkey %para especificar os nomes de ficheiros novos ou antigos. Para mais informações sobre %tokens strkey%, consulte a Secção INF Strings.
Examples
Este exemplo mostra uma secção referenciada por uma diretiva RenFiles .
[RenameOldFilesSec]
devfile41.sav, devfile41.sys