Arahan INF UpdateIniFields
Perhatian
Mulai Windows 11 versi 22H2, paket driver yang menggunakan arahan ini tidak lagi memenuhi syarat untuk tanda tangan dari Pusat Pengembang Perangkat Keras.
Paket pengandar universal dan Driver Windows tidak dapat menggunakan direktif ini.
Direktif UpdateIniFields mereferensikan satu atau beberapa bagian bernama di mana modifikasi mendetail dalam baris file INI dapat 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)
UpdateIniFields=update-inifields-section[,update-inifields-section]...
Setiap bagian bernama yang direferensikan oleh direktif UpdateIniFields memiliki formulir berikut:
[update-inifields-section]
ini-file,ini-section,profile-name[,old-field][,new-field][,flags]
...
Bagian update-inifields dapat memiliki jumlah entri yang ditentukan inf-writer, masing-masing pada baris terpisah.
Entri
ini-file
Menentukan nama file INI yang disediakan pada media sumber dan, secara implisit, file INI yang akan diperbarui pada komputer target. Nilai ini dapat dinyatakan sebagai nama file atau sebagai token %strkey% yang didefinisikan di bagian String dari file INF.
ini-bagian
Menentukan nama bagian dalam file INI yang diberikan yang berisi baris yang akan dimodifikasi.
nama profil
Menentukan nama baris yang akan dimodifikasi dalam bagian INI yang diberikan. Setidaknya salah satu entri bidang lama dan/atau bidang baru harus ditentukan untuk mempengaruhi modifikasi baris ini.
bidang lama
Menentukan bidang yang ada dalam baris yang diberikan. Jika bidang baru dihilangkan dari entri bagian ini, bidang ini dihapus dari baris yang diberikan. Jika tidak, nilai bidang baru yang diberikan harus menggantikan bidang ini.
bidang baru
Menentukan pengganti untuk bidang lama tertentu atau, jika bidang lama dihilangkan, tambahan ke baris yang diberikan.
flags
Menentukan (dalam bit 0) cara menginterpretasikan bidang lama-dan/atau bidang baru-jika atau keduanya berisi tanda bintang (*), dan/atau (dalam bit 1) karakter pemisah mana yang akan digunakan saat menambahkan bidang baru tertentu ke baris yang diberikan, sebagai berikut:
Bit nol = 0
Interpretasikan tanda bintang apa pun (*) dalam entri bidang lama dan/atau bidang baru yang ditentukan secara harfiah, bukan sebagai karakter kartubebas, saat mencari kecocokan di baris tertentu dari file INI. Ini adalah nilai default.
Bit nol = 1
Menginterpretasikan tanda bintang apa pun (*) dalam entri bidang lama dan/atau bidang baru yang ditentukan sebagai karakter kartubebas saat mencari kecocokan di baris tertentu dari file INI.
Bit satu = 0
Gunakan karakter spasi sebagai pemisah saat menambahkan entri bidang baru yang ditentukan ke baris tertentu dari file INI. Ini adalah nilai default.
Bit satu = 1
Gunakan koma (,) sebagai pemisah saat menambahkan entri bidang baru yang ditentukan ke baris tertentu dari file INI.
Keterangan
Direktif UpdateIniFields hampir tidak pernah ditentukan dalam file INF untuk penginstalan di Windows karena tidak perlu memiliki file INI di media distribusi mereka. Namun, direktif UpdateIniFields valid di salah satu bagian yang ditunjukkan dalam pernyataan sintaksis formal, serta di bagian yang ditentukan penulis INF yang direferensikan oleh direktif AddInterface atau direferensikan di bagian InterfaceInstall32.
Setiap nama bagian update-inifields harus unik untuk file INF. Setiap nama bagian yang dibuat inf-writer harus unik dalam file INF dan harus mengikuti aturan umum untuk menentukan nama bagian. Untuk informasi selengkapnya tentang aturan ini, lihat Aturan Sintaks Umum untuk File INF.
Tidak seperti bagian yang direferensikan oleh direktif UpdateInis , bagian yang direferensikan oleh UpdateIniFields menggantikan, menambahkan, atau menghapus bagian dari baris dalam baris file INI yang ada alih-alih memengaruhi seluruh nilai baris tertentu. Setidaknya salah satu nilai bidang lama dan/atau bidang baru harus ditentukan di setiap entri bagian.
Setiap komentar dalam baris file INI yang akan dimodifikasi dihapus karena mungkin tidak berlaku setelah perubahan dibuat sesuai dengan bagian ini. Saat mencari bidang di baris dalam file INI, spasi, tab, dan koma ditafsirkan sebagai pemisah bidang. Namun, karakter spasi digunakan sebagai pemisah default saat bidang baru ditambahkan ke baris.
INF menyediakan jalur lengkap file ini yang diberikan pada media distribusi dengan salah satu cara berikut:
Dalam file INF yang disediakan IHV/OEM, dengan menggunakan bagian SourceDisksNames dan SourceDisksFiles dari INF ini untuk secara eksplisit menentukan jalur lengkap dari setiap file sumber bernama yang tidak ada di direktori akar (atau direktori) pada media distribusi.
Dalam file INF yang disediakan sistem, dengan menyediakan satu atau beberapa file INF tambahan, yang diidentifikasi dalam entri LayoutFile di bagian Versi file INF.