Directiva RenFiles inf

  • Artículo

Precaución

Si va a crear un paquete universal o de Windows Driver, esta directiva no es válida. Consulta Usar un archivo INF universal y Introducción con controladores de Windows.

Una directiva RenFiles hace referencia a una sección definida por INF-writer en otra parte del archivo INF, lo que hace que se cambie el nombre de la lista de archivos en el contexto de las operaciones de la sección en la que se especifica la directiva RenFiles de referencia.

[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]...

Se puede especificar una directiva RenFiles dentro de cualquiera de las secciones que se muestran en la instrucción de sintaxis formal. Esta directiva también se puede especificar en cualquiera de las siguientes secciones definidas por INF-writer:

Cada sección con nombre a la que hace referencia una directiva RenFiles tiene una o varias entradas de la forma siguiente:

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

Una sección de lista de archivos puede tener cualquier número de entradas, cada una en una línea independiente.

Entradas

new-dest-file-name
Especifica el nuevo nombre que se va a asignar al archivo en el destino.

old-source-file-name
Especifica el nombre antiguo del archivo.

Comentarios

Importante

Esta directiva debe usarse cuidadosamente. Se recomienda encarecidamente no usar la directiva RenFiles en el archivo INF para un controlador de función de Plug and Play (PnP).

Cualquier nombre de sección de lista de archivos debe ser único para el archivo INF, pero se puede hacer referencia a él mediante las directivas CopyFiles, DelFiles o RenFiles en otra parte del mismo INF. Este nombre de sección definido por INF-writer debe seguir las reglas generales para definir nombres de sección. Para obtener más información sobre estas reglas, vea Reglas de sintaxis general para archivos INF.

La directiva RenFiles no admite la decoración de un nombre de sección file-list-section con una extensión de plataforma definida por el sistema (.nt, .ntx86, .ntia64, .ntamd64, .ntarm o .ntarm64).

La sección DestinationDirs del archivo INF controla el destino de todas las operaciones de cambio de nombre de archivo, independientemente de la sección que contenga una directiva RenFiles determinada. Las reglas siguientes describen la operación de cambio de nombre de archivo:

  • Si una sección con nombre a la que hace referencia una directiva RenFiles tiene una entrada correspondiente en la sección DestinationDirs de la misma INF, esa entrada especifica explícitamente el directorio de destino de destino. Todos los archivos que aparecen en la sección con nombre se cambian de nombre en el destino antes de copiar estos archivos de origen.

  • Si una sección con nombre no aparece en la sección DestinationDirs , Windows usa la entrada DefaultDestDir en la sección DestinationDirs del INF.

Nota

No puede usar un token %strkey% para especificar los nombres de archivo nuevos o antiguos. Para obtener más información sobre %strkey% tokens, vea sección Cadenas INF.

Ejemplos

En este ejemplo se muestra una sección a la que hace referencia una directiva RenFiles .

[RenameOldFilesSec]
devfile41.sav, devfile41.sys

Consulte también

AddInterface

ClassInstall32

CopyFiles

DDInstall

DelFiles

DestinationDirs

InterfaceInstall32

SourceDisksFiles

SourceDisksNames

Cadenas

Versión