Directive INF RenFiles
Attention
Si vous créez un package de pilote universel ou Windows, cette directive n’est pas valide. Veuillez consulter la section Utilisation d’un fichier INF universel et Premiers pas dans le développement de pilotes Windows.
Une directive RenFiles fait référence à une section définie par le writer de l’INF ailleurs dans le fichier INF, ce qui entraîne le renommage de cette liste de fichiers dans le cadre des opérations sur la section dans laquelle la directive RenFiles est spécifiée.
[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]...
Une directive RenFiles peut être spécifiée dans n’importe laquelle des sections présentées dans la déclaration de syntaxe formelle. Cette directive peut également être spécifiée dans l’une des sections suivantes définies par l’auteur de l’INF :
- Une section add-interface-section référencée par la directive AddInterface dans une section DDInstall.Interfaces.
- Une section install-interface référencée dans une section InterfaceInstall32.
Chaque section nommée à laquelle fait référence une directive RenFiles comporte une ou plusieurs entrées sous la forme suivante :
[file-list-section]
new-dest-file-name,old-source-file-name
...
Une file-list-section peut comporter un nombre quelconque d’entrées, chacune sur une ligne distincte.
Entries
new-dest-file-name
Spécifie le nouveau nom à attribuer au fichier sur la destination.
old-source-file-name
Spécifie l’ancien nom du fichier.
Notes
Important
Cette directive doit être utilisée avec précaution. Nous vous recommandons fortement de ne pas utiliser la directive RenFiles dans le fichier INF pour un pilote de fonction Plug and Play (PnP).
Tout nom de file-list-section doit être unique pour le fichier INF, mais il peut être référencé par des directives CopyFiles, DelFiles, ou RenFiles ailleurs dans le même INF. Un tel nom de section défini par l’auteur de l’INF doit suivre les règles générales de définition des noms de section. Pour plus d'informations sur ces règles, voir Règles générales de syntaxe pour les fichiers INF.
La directive RenFiles ne prend pas en charge la décoration d’un nom de section file-list avec une extension de plateforme définie par le système (.nt, .ntx86, .ntia64, .ntamd64, .ntarm ou .ntarm64).
La section DestinationDirs du fichier INF contrôle la destination de toutes les opérations de renommage de fichiers, quelle que soit la section qui contient une directive RenFiles spécifique. Les règles suivantes décrivent l’opération de renommage de fichiers :
Si une section nommée à laquelle fait référence une directive RenFiles a une entrée correspondante dans la section DestinationDirs du même INF, cette entrée spécifie explicitement le répertoire de destination cible. Tous les fichiers répertoriés dans la section nommée sont renommés sur la destination avant que ces fichiers sources ne soient copiés.
Si une section nommée n’est pas listée dans la section DestinationDirs, Windows utilise l’entrée DefaultDestDir dans la section DestinationDirs du fichier INF.
Remarque
Vous ne pouvez pas utiliser un jeton %strkey% pour spécifier les nouveaux ou anciens noms de fichiers. Pour plus d’informations sur les jetons %strkey%, veuillez consulter la section INF Strings.
Exemples
Cet exemple montre une section référencée par une directive RenFiles.
[RenameOldFilesSec]
devfile41.sav, devfile41.sys