Direttiva INF RenFiles
Attenzione
Se stai creando un pacchetto universale o windows Driver, questa direttiva non è valida. Vedi Uso di un file INF universale e Introduzione allo sviluppo di driver windows.
Una direttiva RenFiles fa riferimento a una sezione INF-writer-defined altrove nel file INF, che fa sì che tale elenco di file venga rinominato nel contesto delle operazioni nella sezione in cui viene specificata la direttiva RenFiles di riferimento.
[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]...
È possibile specificare una direttiva RenFiles all'interno di qualsiasi sezione illustrata nell'istruzione di sintassi formale. Questa direttiva può essere specificata anche all'interno di una delle sezioni INF-writer-defined seguenti:
- Sezione add-interface a cui fa riferimento la direttiva AddInterface in un DDInstall. Sezione Interfacce.
- Sezione install-interface-referenced in una sezione InterfaceInstall32.
Ogni sezione denominata a cui fa riferimento una direttiva RenFiles include una o più voci del formato seguente:
[file-list-section]
new-dest-file-name,old-source-file-name
...
Una sezione file-list-section può avere un numero qualsiasi di voci, ognuna su una riga separata.
whse.
new-dest-file-name
Specifica il nuovo nome da assegnare al file nella destinazione.
old-source-file-name
Specifica il nome precedente del file.
Osservazioni:
Importante
Questa direttiva deve essere utilizzata con attenzione. È consigliabile non usare la direttiva RenFiles nel file INF per un driver di funzione Plug and Play (PnP).
Qualsiasi nome di sezione file-list deve essere univoco per il file INF, ma può essere fatto riferimento dalle direttive CopyFiles, DelFiles o RenFiles altrove nello stesso INF. Un nome di sezione definito da INF-writer deve seguire le regole generali per la definizione dei nomi di sezione. Per altre informazioni su queste regole, vedere Regole di sintassi generali per i file INF.
La direttiva RenFiles non supporta la decorazione di un nome di sezione file-list con estensione della piattaforma definita dal sistema (.nt, .ntx86, .ntia64, .ntamd64, .ntarm o .ntarm64).
La sezione DestinationDirs del file INF controlla la destinazione per tutte le operazioni di ridenominazione dei file, indipendentemente dalla sezione che contiene una specifica direttiva RenFiles . Le regole seguenti descrivono l'operazione di ridenominazione file:
Se una sezione denominata a cui fa riferimento una direttiva RenFiles ha una voce corrispondente nella sezione DestinationDirs nello stesso INF, tale voce specifica in modo esplicito la directory di destinazione. Tutti i file elencati nella sezione denominata vengono rinominati nella destinazione prima che questi file di origine vengano copiati.
Se una sezione denominata non è elencata nella sezione DestinationDirs , Windows usa la voce DefaultDestDir nella sezione DestinationDirs di INF.
Nota
Non è possibile utilizzare un token %strkey% per specificare i nomi di file nuovi o precedenti. Per altre informazioni sui token %strkey%, vedere la sezione Stringhe INF.
Esempi
Questo esempio mostra una sezione a cui fa riferimento una direttiva RenFiles .
[RenameOldFilesSec]
devfile41.sav, devfile41.sys