Section INF DestinationDirs

Article
02/02/2024

Une section DestinationDirs spécifie le ou les répertoires de destination cibles pour toutes les opérations de copie, de suppression et/ou de renommage sur les fichiers référencés par nom ailleurs dans le fichier INF.

[DestinationDirs]

[DefaultDestDir=dirid[,subdir]] 
[file-list-section=dirid[,subdir]]...

Entrées

DefaultDestDir=dirid[,subdir]
Spécifie le répertoire de destination par défaut pour toutes les opérations de copie, de suppression et/ou de renommage sur les fichiers qui ne sont pas explicitement répertoriés dans une section de liste de fichiers référencée par d’autres entrées ici. Pour garantir que les opérations de fichier se produisent toujours dans le répertoire approprié, un fichier INF qui inclut les entrées Include et Needs ne doit pas spécifier de répertoire de destination par défaut. Pour plus d'informations, consultez la section Notes qui suit.

file-list-section=dirid[,subdir]] ...
Spécifie le nom déterminé par l’enregistreur INF d’une section référencée par une directive CopyFiles, RenFiles ou DelFiles ailleurs dans le fichier INF. Cette entrée est facultative si cette section a une entrée DefaultDestDir et que toutes les opérations de copie de fichier spécifiées dans cet INF ont la même destination cible. Toutefois, toute section de liste de fichiers référencée par une directive RenFiles ou DelFiles ailleurs dans l’INF doit être répertoriée ici.

dirid
Spécifie l’identificateur de répertoire du répertoire cible pour les opérations sur les fichiers référencés par nom, éventuellement dans une section de liste de fichiers nommée de l’INF. Pour obtenir la liste des dirids couramment utilisés, consultez Utilisation de dirids. Sur Windows 10 version 1709 et versions ultérieures de Windows, il est recommandé d’utiliser DIRID 13. Pour plus d’informations, consultez Exécuter à partir du magasin de pilotes.

Sous-répertoire
Spécifie le sous-répertoire (et le reste de son chemin, le cas échéant, sous le répertoire identifié par dirid) comme destination des opérations de fichier dans la section file-list donnée.

Remarques

La section DestinationDirs est requise dans tout fichier INF qui utilise une directive INF CopyFiles ou qui fait référence à une section file-list, qu’il s’agisse d’une directive CopyFiles, DelFiles ou RenFiles .

Si Abc.inf inclut des sections d’un autre fichier INF, Def.inf, et que les deux fichiers INF incluent une entrée DefaultDestDir pour les opérations copy-file, rename-file ou delete-file, Windows ignore le répertoire de destination par défaut spécifié dans Def.inf et effectue toutes les opérations de fichier correspondantes dans le répertoire de destination par défaut spécifié dans Abc.inf.

Pour garantir que les opérations de fichier se produisent toujours dans les répertoires appropriés, un fichier INF qui inclut des entrées Include et Needs ne doit pas inclure d’entrée DefaultDestDir dans une section DestinationDirs . Au lieu de cela, un tel fichier INF doit explicitement référencer tous les noms de section de liste de fichiers spécifiés par les directives CopyFiles, RenFiles et DelFiles dans la section DestinationDirs .

Si un fichier INF n’inclut pas les entrées Include et Needs , l’inf peut utiliser l’entrée DefaultDestDir pour spécifier une destination par défaut pour les opérations de copie, de renommage et de suppression de fichier qui apparaissent ailleurs dans le fichier INF :

Les directives CopyFiles qui utilisent la notation de copie directe (@filename) doivent avoir une entrée DefaultDestDir dans la section DestinationDirs de l’INF dans laquelle l’entrée de copie directe s’affiche.
Les sections CopyFiles, RenFiles ou DelFiles qui ne sont pas directement référencées dans la section DestinationDirs doivent avoir une entrée DefaultDestDir dans la section DestinationDirs de l’INF dans laquelle les sections de fichier copier, renommer et supprimer apparaissent.

Exemples

Cet exemple montre comment définir le répertoire cible par défaut pour toutes les opérations copy-file, delete-file et rename-file. Une section DestinationDirs aussi simple est commune aux fichiers INF pour les nouveaux périphériques, car un tel inf copie généralement simplement un ensemble de fichiers sources dans un répertoire unique sur l’ordinateur cible.

[DestinationDirs]
DefaultDestDir = 13

Cet exemple montre un fragment de la section DestinationDirs de l’INF pour un pilote d’affichage/vidéo.

[DestinationDirs]
DefaultDestDir     = 13

; ... 

; list of per-Manufacturer, per-Models, per-DDInstall-section, and
; CopyFiles-referenced xxx.Miniport/xxx.Display sections omitted here
; along with several other miniport/display paired drivers
; ...
vga.Miniport     = 13
vga.Display      = 13
xga.Miniport     = 13
xga.Display      = 13