Section INF DestinationDirs

Une section DestinationDirs spécifie le répertoire de destination cible ou les répertoires 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 file-list référencée par d’autres entrées ici. Pour vous assurer que les opérations de fichier se produisent toujours dans le répertoire correct, un fichier INF qui inclut les entrées Include et Needs ne doit pas spécifier un répertoire de destination par défaut. Pour plus d’informations, consultez la section Remarques suivante.

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. Une telle entrée est facultative si cette section a une entrée DefaultDestDir et que toutes les opérations de copie-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 des listes de 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, voir Exécuter à partir du Magasin des pilotes .

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

Remarks

La section DestinationDirs est requise dans n’importe quel fichier INF qui utilise une directive CopyFiles INF ou qui fait référence à une section de liste de fichiers, 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 vous assurer que les opérations de fichier se produisent toujours dans les répertoires appropriés, un fichier INF qui inclut les 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 référencer explicitement 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 d’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 fichiers 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 copier, renommer et supprimer des fichiers apparaissent.

Examples

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 telle section DestinationDirs simple est commune aux fichiers INF pour les nouveaux périphériques, car un tel INF copie généralement 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

Voir aussi

CopyFiles

DDInstall

DelFiles

RenFiles

SourceDisksFiles

SourceDisksNames

Utilisation de Dirids