Directiva RenFiles de INF
Precaución
Si va a crear un paquete de controladores universal o de Windows, esta directiva no es válida. Consulte Uso de un archivo INF universal e Introducción al desarrollo de controladores de Windows.
Una directiva RenFiles hace referencia a una sección INF-writer-defined en otra parte del archivo INF 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 en cualquiera de las secciones que se muestran en la instrucción de sintaxis formal anterior. Esta directiva también se puede especificar en cualquiera de las siguientes secciones INF-writer-defined:
- Una add-interface-section a la que hace referencia la directiva AddInterface en una sección DDInstall.Interfaces.
- Una install-interface-section a la que se hace referencia en una sección InterfaceInstall32.
Cada sección con nombre a la que hace referencia una directiva RenFiles tiene una o varias entradas con el formato siguiente:
[file-list-section]
new-dest-file-name,old-source-file-name
...
Una file-list-section puede tener cualquier número de entradas, cada una en una línea independiente.
Entries
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 Plug and Play (PnP).
Cualquier nombre de file-list-section 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 tipo de nombre de sección INF-writer-defined debe seguir las reglas generales para definir nombres de sección. Para obtener más información sobre estas reglas, consulte Reglas generales de sintaxis para archivos INF.
La directiva RenFiles no admite la representación de un nombre de 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 archivos, independientemente de la sección que contenga una directiva determinada RenFiles. 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 del mismo INF, esa entrada especifica explícitamente el directorio de destino. Se cambia el nombre de todos los archivos que aparecen en la sección con 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 de 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, consulte la Sección Strings de INF.
Ejemplos
En este ejemplo se muestra una sección a la que hace referencia una directiva RenFiles.
[RenameOldFilesSec]
devfile41.sav, devfile41.sys