Direktif INF RenFiles
Perhatian
Jika Anda membangun paket Driver universal atau Windows, arahan ini tidak valid. Lihat Menggunakan File INF Universal dan Memulai Driver Windows.
Direktif RenFiles mereferensikan bagian yang ditentukan inf-writer di tempat lain dalam file INF, yang menyebabkan daftar file tersebut diganti namanya dalam konteks operasi pada bagian di mana direktif RenFiles 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)
Renfiles=file-list-section[,file-list-section]...
Direktif RenFiles 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 RenFiles memiliki satu atau beberapa entri formulir berikut:
[file-list-section]
new-dest-file-name,old-source-file-name
...
Bagian daftar file dapat memiliki sejumlah entri, masing-masing pada baris terpisah.
Entri
new-dest-file-name
Menentukan nama baru yang akan diberikan ke file pada tujuan.
old-source-file-name
Menentukan nama lama file.
Keterangan
Penting
Arahan ini harus digunakan dengan hati-hati. Kami sangat menyarankan agar Anda tidak menggunakan direktif RenFiles 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 RenFiles tidak mendukung dekorasi nama bagian daftar file dengan ekstensi platform yang ditentukan sistem (.nt, .ntx86, .ntia64, .ntamd64, .ntarm, atau .ntarm64).
Bagian DestinationDirs dari file INF mengontrol tujuan untuk semua operasi penggantian nama file, terlepas dari bagian yang berisi direktif RenFiles tertentu. Aturan berikut menjelaskan operasi penggantian nama file:
Jika bagian bernama yang direferensikan oleh direktif RenFiles memiliki entri yang sesuai di bagian DestinationDirs di INF yang sama, entri tersebut secara eksplisit menentukan direktori tujuan target. Semua file yang tercantum di bagian bernama diganti namanya pada tujuan sebelum file sumber ini disalin.
Jika bagian bernama tidak tercantum di bagian DestinationDirs , Windows menggunakan entri DefaultDestDir di bagian DestinationDirs inf.
Catatan
Anda tidak dapat menggunakan token %strkey% untuk menentukan nama file baru atau lama. Untuk informasi selengkapnya tentang token %strkey%, lihat Bagian String INF.
Contoh
Contoh ini memperlihatkan bagian yang direferensikan oleh direktif RenFiles .
[RenameOldFilesSec]
devfile41.sav, devfile41.sys