INF DestinationDirs Section

[DestinationDirs]

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

Description

A DestinationDirs section specifies the target destination directory or directories for all copy, delete, and/or rename operations on files referenced by name elsewhere in the INF file.

Entries

DefaultDestDir=dirid[,subdir]

Specifies the default destination directory for all copy, delete, and/or rename operations on files that are not explicitly listed in a file-list-section referenced by other entries here. To ensure that file operations always occur in the correct directory, an INF file that includes Include and Needs entries should not specify a default destination directory. For more information, see the following Remarks section.

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

Specifies the INF-writer-determined name of a section referenced by a CopyFiles, RenFiles, or DelFiles directive elsewhere in the INF file. Such an entry is optional if this section has a DefaultDestDir entry and all copy-file operations specified in this INF have the same target destination. However, any file-list-section referenced by a RenFiles or DelFiles directive elsewhere in the INF must be listed here.

dirid

Specifies the directory identifier of the target directory for operations on files that are referenced by name, possibly within a named file-list-section of the INF. For lists of commonly used dirids, see Using Dirids.

subdir

Specifies the subdirectory (and the rest of its path, if any, under the directory identified by dirid) to be the destination of the file operations in the given file-list-section.

Remarks

The DestinationDirs section is required in any INF file that uses an INF CopyFiles directive or that references a file-list-section, whether with a CopyFiles, DelFiles, or RenFiles directive.

If Abc.inf includes sections from another INF file, Def.inf, and both INF files include a DefaultDestDir entry for copy-file, rename-file, or delete-file operations, Windows ignores the default destination directory that is specified in Def.inf and performs all the corresponding file operations in the default destination directory that is specified in Abc.inf.

To ensure that file operations always occur in the correct directories, an INF file that includes Include and Needs entries should not include a DefaultDestDir entry in a DestinationDirs section. Instead, such an INF file should explicitly reference all the file-list-section names that are specified by CopyFiles, RenFiles, and DelFiles directives in the DestinationDirs section.

If an INF file does not include Include and Needs entries, the INF can use the DefaultDestDir entry to specify a default destination for copy, rename, and delete file operations that appear elsewhere in the INF file:

  • CopyFiles directives that use the direct copy (@filename) notation must have a DefaultDestDir entry in the DestinationDirs section of the INF in which the direct-copy entry appears.
  • CopyFiles, RenFiles, or DelFiles sections that are not directly referenced in the DestinationDirs section must have a DefaultDestDir entry in the DestinationDirs section of the INF in which the copy, rename, and delete file sections appear.

Examples

This example sets the default target directory for all copy-file, delete-file, and rename-file operations. Such a simple DestinationDirs section is common to INF files for new peripheral devices, because such an INF usually just copies a set of source files into a single directory on the target computer.


[DestinationDirs]
DefaultDestDir = 12 ; dirid = \Drivers on WinNT platforms

This example shows a fragment of the DestinationDirs section of the INF for display/video drivers.


[DestinationDirs]
DefaultDestDir     = 11 ; dirid = \system32 on WinNT platforms

; ... 

; 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     = 12
vga.Display      = 11
xga.Miniport     = 12
xga.Display      = 11

; all video miniports copied into \system32\drivers on WinNT platforms
; all paired display drivers copied into \system32

See also

ClassInstall32
CopyFiles
DDInstall
DelFiles
RenFiles
SourceDisksFiles
SourceDisksNames
Version

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft