Direktif INF DelFiles

Artikel
03/08/2023

Perhatian

Jika Anda membangun paket Driver universal atau Windows, arahan ini tidak valid. Lihat Menggunakan File INF Universal dan Memulai Driver Windows.

Direktif DelFiles mereferensikan bagian yang ditentukan penulis INF di tempat lain dalam file INF, dan menyebabkan daftar file dihapus dalam konteks operasi pada bagian di mana arahan DelFiles yang merujuk ditentukan.

[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) 
  
Delfiles=file-list-section[,file-list-section]...

Direktif DelFiles dapat ditentukan dalam salah satu bagian yang ditunjukkan dalam pernyataan sintaks formal. Arahan ini juga dapat ditentukan dalam salah satu bagian yang ditentukan inf-writer berikut:

Bagian add-interface yang direferensikan oleh direktif AddInterface dalam DDInstall. Bagian antarmuka .
Bagian antarmuka penginstalan yang dirujuk di bagian InterfaceInstall32

Setiap bagian bernama yang direferensikan oleh direktif DelFiles memiliki satu atau beberapa entri formulir berikut:

[file-list-section]
 
destination-file-name[,,,flag]
...

Bagian daftar file dapat memiliki sejumlah entri, masing-masing pada baris terpisah.

Entri

destination-file-name
Menentukan nama file yang akan dihapus dari tujuan.

Jangan tentukan file yang tercantum dalam direktif CopyFiles . Jika file tercantum di bagian yang direferensikan CopyFiles dan yang direferensikan DelFiles, dan file saat ini ada di sistem dengan tanda tangan yang valid, sistem operasi mungkin mengoptimalkan operasi penyalinan tetapi melakukan operasi penghapusan. Ini sangat mungkin tidak apa yang dimaksudkan penulis INF.

Catatan

Anda tidak dapat menggunakan token %strkey% untuk menentukan entri destination-file-name. Untuk informasi selengkapnya tentang token %strkey%, lihat Bagian String INF.

Bendera
Nilai opsional ini bisa menjadi salah satu dari berikut ini, yang dinyatakan dalam notasi heksadesimal seperti yang ditunjukkan di sini atau sebagai nilai desimal:

0x00000001 (DELFLG_IN_USE)
Hapus file bernama, mungkin setelah digunakan selama proses penginstalan.

Mengatur nilai bendera ini dalam INF mengantre operasi penghapusan file hingga sistem dimulai ulang jika file yang diberikan tidak dapat dihapus karena sedang digunakan saat INF ini sedang diproses. Jika tidak, file seperti itu tidak akan dihapus.

0x00010000 (DELFLG_IN_USE1) (Windows 2000 atau versi Windows yang lebih baru)
Bendera ini adalah versi kata tinggi dari bendera DELFLG_IN_USE, dan memiliki tujuan dan efek yang sama. Bendera ini harus digunakan hanya untuk penginstalan pada sistem berbasis NT.

Mengatur nilai bendera ini dalam INF mencegah konflik dengan bendera COPYFLG_WARN_IF_SKIP dalam INF dengan arahan DelFiles dan CopyFiles yang mereferensikan bagian daftar file yang sama.

Keterangan

Penting

Arahan ini harus digunakan dengan hati-hati. Kami sangat menyarankan agar Anda tidak menggunakan direktif DelFiles dalam file INF untuk driver fungsi Plug and Play (PnP).

Nama bagian daftar file apa pun harus unik untuk file INF, tetapi dapat direferensikan oleh direktif CopyFiles, DelFiles, atau RenFiles di tempat lain di INF yang sama. Nama bagian yang ditentukan penulis INF tersebut harus mengikuti aturan umum untuk menentukan nama bagian. Untuk informasi selengkapnya tentang aturan ini, lihat Aturan Sintaks Umum untuk File INF.

Direktif DelFiles tidak mendukung dekorasi nama file-list-section dengan ekstensi platform yang ditentukan sistem (.nt, .ntx86, .ntia64, .ntamd64, .ntarm, atau .ntarm64).

Bagian DestinationDirs dari file INF mengontrol tujuan untuk semua operasi penghapusan file, terlepas dari bagian yang berisi arahan DelFiles tertentu. Jika bagian bernama yang direferensikan oleh direktif DelFiles memiliki entri terkait di bagian DestinationDirs dari INF yang sama, entri tersebut secara eksplisit menentukan direktori tujuan target tempat semua file yang tercantum di bagian bernama akan dihapus. Jika bagian bernama tidak tercantum di bagian DestinationDirs , Windows menggunakan entri DefaultDestDir di INF.

Contoh

Contoh ini menunjukkan bagaimana bagian DestinationDirs menentukan jalur untuk operasi delete-file yang terjadi dalam memproses INF driver perangkat sederhana.

[DestinationDirs]
DefaultDestDir = 12  ; DIRID_DRIVERS 

; ... 

[AHA154X]
CopyFiles=@AHA154x.MPD
DelFiles=ASPIDEV ; defines delete-files section name
; ... some other directives and sections omitted here

[ASPIDEV]
VASPID.SYS ; name of file to be deleted, if it exists on target 
; ...