Directive RenFiles INF
Attention
Si vous créez un package universel ou Windows Driver, cette directive n’est pas valide. Consultez Utilisation d’un fichier INF universel et Prise en main avec des pilotes Windows.
Une directive RenFiles fait référence à une section définie par un enregistreur INF ailleurs dans le fichier INF, ce qui entraîne le renommage de cette liste de fichiers dans le contexte des opérations sur la section dans laquelle la directive RenFiles de référence 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 l’une des sections indiquées dans l’instruction de syntaxe formelle. Cette directive peut également être spécifiée dans l’une des sections suivantes définies par l’enregistreur INF :
- Section d’interface supplémentaire référencée par la directive AddInterface dans un DDInstall. Section Interfaces .
- Une section install-interface référencée dans une section InterfaceInstall32 .
Chaque section nommée référencée par une directive RenFiles a une ou plusieurs entrées de la forme suivante :
[file-list-section]
new-dest-file-name,old-source-file-name
...
Une section de liste de fichiers peut avoir n’importe quel nombre d’entrées, chacune sur une ligne distincte.
Entrées
new-dest-file-name
Spécifie le nouveau nom à donner au fichier sur la destination.
old-source-file-name
Spécifie l’ancien nom du fichier.
Remarques
Important
Cette directive doit être utilisée avec soin. Nous vous recommandons vivement de ne pas utiliser la directive RenFiles dans le fichier INF pour un pilote de fonction Plug-and-Play (PnP).
Tout nom de section de liste de fichiers doit être unique au fichier INF, mais il peut être référencé par les directives CopyFiles, DelFiles ou RenFiles ailleurs dans le même INF. Un tel nom de section défini par l’enregistreur INF doit respecter les règles générales de définition des noms de section. Pour plus d’informations sur ces règles, consultez Règles de syntaxe générales pour les fichiers INF.
La directive RenFiles ne prend pas en charge la décoration d’un nom de section de liste de fichiers 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 fichier, quelle que soit la section qui contient une directive RenFiles particulière. Les règles suivantes décrivent l’opération de renommage de fichier :
Si une section nommée référencée par une directive RenFiles a une entrée correspondante dans la section DestinationDirs dans le 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 répertoriée dans la section DestinationDirs , Windows utilise l’entrée DefaultDestDir dans la section DestinationDirs du fichier INF.
Notes
Vous ne pouvez pas utiliser un jeton %strkey% pour spécifier le nouveau ou l’ancien nom de fichier. Pour plus d’informations sur les jetons %strkey%, consultez la section Chaînes INF.
Exemples
Cet exemple montre une section référencée par une directive RenFiles .
[RenameOldFilesSec]
devfile41.sav, devfile41.sys