Direttiva INF RenFiles

Articolo
06/15/2023

Attenzione

Se si sta creando un pacchetto universale o Windows Driver, questa direttiva non è valida. Vedere Uso di un file INF universale e Introduzione con i driver di Windows.

Una direttiva RenFiles fa riferimento a una sezione definita dal writer INF altrove nel file INF, che causa la ridenominazione di tale elenco di file nel contesto delle operazioni nella sezione in cui è specificata la direttiva RenFiles che fa 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 una delle sezioni visualizzate nell'istruzione di sintassi formale. Questa direttiva può essere specificata anche all'interno di una delle sezioni INF-writer-definite seguenti:

Sezione add-interface a cui fa riferimento la direttiva AddInterface in un DDInstall. Sezione Interfacce .
Riferimento a una sezione install-interface-section in una sezione InterfaceInstall32 .

Ogni sezione denominata a cui fa riferimento una direttiva RenFiles include una o più voci del modulo seguente:

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

Una sezione elenco file può avere un numero qualsiasi di voci, ognuna in una riga separata.

Voci

new-dest-file-name
Specifica il nuovo nome da assegnare al file nella destinazione.

old-source-file-name
Specifica il nome precedente del file.

Commenti

Importante

Questa direttiva deve essere usata attentamente. È consigliabile non usare la direttiva RenFiles nel file INF per un driver di funzione Plug and Play (PnP).

Qualsiasi nome della sezione elenco file deve essere univoco per il file INF, ma può essere fatto riferimento da CopyFiles, DelFiles o direttive RenFiles altrove nello stesso INF. Tale nome di sezione definito dal writer INF deve seguire le regole generali per definire i 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 di file con un'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 contenente 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 dell'INF.

Nota

Non è possibile usare un token %strkey% per specificare i nomi di file nuovi o vecchi. Per altre informazioni sui token %strkey%, vedere sezione Stringhe INF.

Esempio

Questo esempio mostra una sezione a cui fa riferimento una direttiva RenFiles .

[RenameOldFilesSec]
devfile41.sav, devfile41.sys

Vedi anche

InterfaceInstall32

Condividi tramite