Bagian DestinationDirs INF

Artikel
04/13/2023

Bagian DestinationDirs menentukan direktori atau direktori tujuan target untuk semua operasi salin, hapus, dan/atau ganti nama pada file yang direferensikan berdasarkan nama di tempat lain dalam file INF.

[DestinationDirs]

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

Entri

DefaultDestDir=dirid[,subdir]
Menentukan direktori tujuan default untuk semua operasi salin, hapus, dan/atau ganti nama pada file yang tidak secara eksplisit tercantum dalam bagian daftar file yang direferensikan oleh entri lain di sini. Untuk memastikan bahwa operasi file selalu terjadi di direktori yang benar, file INF yang menyertakan entri Sertakan dan Kebutuhan tidak boleh menentukan direktori tujuan default. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

file-list-section=dirid[,subdir]] ...
Menentukan nama bagian yang ditentukan penulis INF yang direferensikan oleh direktif CopyFiles, RenFiles, atau DelFiles di tempat lain dalam file INF. Entri seperti itu bersifat opsional jika bagian ini memiliki entri DefaultDestDir dan semua operasi salin-file yang ditentukan dalam INF ini memiliki tujuan target yang sama. Namun, setiap bagian daftar file yang direferensikan oleh direktif RenFiles atau DelFiles di tempat lain dalam INF harus dicantumkan di sini.

dirid
Menentukan pengidentifikasi direktori direktori target untuk operasi pada file yang direferensikan berdasarkan nama, mungkin dalam bagian daftar file bernama dari INF. Untuk daftar dirid yang umum digunakan, lihat Menggunakan Dirids. Pada Windows 10 versi 1709 dan versi windows yang lebih baru, disarankan agar DIRID 13 digunakan. Lihat menjalankan dari Penyimpanan Driver untuk informasi selengkapnya.

subdir
Menentukan subdirektori (dan sisa jalurnya, jika ada, di bawah direktori yang diidentifikasi oleh dirid) untuk menjadi tujuan operasi file di bagian daftar file yang diberikan.

Keterangan

Bagian DestinationDirs diperlukan dalam file INF apa pun yang menggunakan direktif INF CopyFiles atau yang mereferensikan bagian daftar file, baik dengan direktif CopyFiles, DelFiles, atau RenFiles .

Jika Abc.inf menyertakan bagian dari file INF lain, Def.inf, dan kedua file INF menyertakan entri DefaultDestDir untuk operasi copy-file, rename-file, atau delete-file, Windows mengabaikan direktori tujuan default yang ditentukan dalam Def.inf dan melakukan semua operasi file yang sesuai dalam direktori tujuan default yang ditentukan dalam Abc.inf.

Untuk memastikan bahwa operasi file selalu terjadi di direktori yang benar, file INF yang menyertakan entri Sertakan dan Kebutuhan tidak boleh menyertakan entri DefaultDestDir di bagian DestinationDirs . Sebagai gantinya, file INF seperti itu harus secara eksplisit mereferensikan semua nama bagian daftar file yang ditentukan oleh direktif CopyFiles, RenFiles, dan DelFiles di bagian DestinationDirs .

Jika file INF tidak menyertakan entri Sertakan dan Perlu , INF dapat menggunakan entri DefaultDestDir untuk menentukan tujuan default untuk menyalin, mengganti nama, dan menghapus operasi file yang muncul di tempat lain dalam file INF:

Direktif CopyFiles yang menggunakan notasi salinan langsung (@filename) harus memiliki entri DefaultDestDir di bagian DestinationDirs inf tempat entri penyalinan langsung muncul.
Bagian CopyFiles, RenFiles, atau DelFiles yang tidak secara langsung direferensikan di bagian DestinationDirs harus memiliki entri DefaultDestDir di bagian DestinationDirs inf tempat bagian salin, ganti nama, dan hapus file muncul.

Contoh

Contoh ini menetapkan direktori target default untuk semua operasi copy-file, delete-file, dan rename-file. Bagian DestinationDirs sederhana seperti itu umum untuk file INF untuk perangkat periferal baru, karena INF seperti itu biasanya hanya menyalin satu set file sumber ke dalam satu direktori pada komputer target.

[DestinationDirs]
DefaultDestDir = 13

Contoh ini menunjukkan fragmen bagian DestinationDirs dari INF untuk driver tampilan/video.

[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