Direktif INF UpdateInis

Artikel
07/08/2024

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 UpdateInis mereferensikan satu atau beberapa bagian bernama, menentukan file INI tempat bagian atau baris tertentu akan dibaca dan diterapkan ke file INI yang ada dengan nama yang sama pada komputer target. Secara opsional, modifikasi baris demi baris dari dan ke file INI tersebut dapat ditentukan di bagian update-ini-section.

[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)

UpdateInis=update-ini-section[,update-ini-section]...

Arahan ini hampir tidak pernah ditentukan dalam file INF untuk penginstalan di Windows, karena kurangnya kebutuhan untuk file INI. Namun, direktif UpdateInis valid di salah satu bagian yang ditampilkan dalam pernyataan sintaks formal, serta di bagian yang ditentukan penulis INF yang direferensikan oleh direktif AddInterface atau direferensikan di bagian InterfaceInstall32.

Setiap bagian bernama yang direferensikan oleh direktif UpdateInis memiliki formulir berikut:

[update-ini-section]
 
ini-file,ini-section[,old-ini-entry][,new-ini-entry][,flags]
...

Bagian update-ini 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. Jika dua nilai berikutnya ditentukan, bagian ini berisi entri yang akan diubah. Jika entri-ini-lama dihilangkan tetapi entri-ini-baru disediakan, entri baru akan ditambahkan saat bagian ini dibaca.

old-ini-entry
Nilai opsional ini menentukan nama entri di bagian ini yang diberikan, biasanya dinyatakan dalam formulir berikut:

"key=value"

Salah satu atau kedua kunci dan nilai dapat diekspresikan sebagai token %strkey% yang ditentukan dalam bagian String dari file INF. Tanda bintang (*) dapat ditentukan sebagai wild-card untuk kunci atau nilai.

new-ini-entry
Nilai opsional ini menentukan perubahan pada entri lama-ini tertentu atau penambahan entri baru. Nilai ini dapat diekspresikan dengan cara yang sama seperti old-ini-entry.

flags
Nilai opsional ini mengontrol interpretasi old-ini-entry dan/atau new-ini-entry yang diberikan. Entri bendera bisa menjadi salah satu nilai numerik berikut:

Nilai	Makna
0	Ini adalah nilai default untuk entri bendera jika dihilangkan. Jika kunci old-ini-entry yang diberikan ada dalam file INI, ganti key=value* tersebut dengan new-ini-entry yang diberikan.* Hanya kunci dalam file INI yang harus cocok. Nilai yang sesuai dari setiap kunci tersebut diabaikan. Untuk menambahkan new-ini-entry ke file INI tujuan tanpa syarat, hilangkan nilai old-ini-entry dari entri di bagian update-ini INF. Untuk menghapus entri-ini-lama dari file INI tujuan tanpa syarat, hilangkan nilai new-ini-entry .
1	Jika old-ini-entry (key=value) yang diberikan ada dalam file INI, ganti dalam file INI tujuan yang memiliki entri baru-ini yang diberikan. Kunci dan nilai entri ini lama yang ditentukan harus cocok dengan yang ada di file INI agar penggantian tersebut dibuat, bukan hanya kunci mereka seperti untuk nilai bendera sebelumnya.
2	Jika kunci yang ditentukan untuk old-ini-entry tidak dapat ditemukan dalam file INI tujuan, jangan lakukan apa pun. Jika tidak, perubahan yang dilakukan tergantung pada kecocokan yang ditemukan dalam file INI untuk kunci yang diberikan dari old-ini-entry dan new-ini-entry, sebagai berikut: (1) Jika kunci entri-ini-lama ada dalam file INI tetapi begitu juga kunci new-ini-entry, ganti old-ini-entry dengan new-ini-entry dalam file INI tujuan dan, kemudian, hapus superfluous new-ini-entry dari file INI tersebut. (2) Jika kunci entri-ini-lama ada dalam file INI tetapi kunci new-ini-entry tidak, ganti kunci old-ini-entry dengan yang dari new-ini-entry dalam file INI tujuan tetapi biarkan nilai entri-ini-lama tidak berubah.
3	Jika kunci dan nilai yang ditentukan untuk old-ini-entry tidak dapat ditemukan dalam file INI, jangan lakukan apa pun. Jika tidak, perubahan yang dilakukan tergantung pada kecocokan yang ditemukan dalam file INI untuk kunci dan nilai yang diberikan dari old-ini-entry dan new-ini-entry, sebagai berikut: (1) Jika key=value dari old-ini-entry ada di file INI tetapi begitu juga key=value dari new-ini-entry, ganti old-ini-entry dengan new-ini-entry dalam file INI tujuan dan, kemudian, hapus new-ini-entry yang berlebihan dari file INI. (2) Jika key=value dari old-ini-entry ada di file INI tetapi new-ini-entry tidak, ganti old-ini-entry dengan new-ini-entry dalam file INI tujuan tetapi biarkan nilai entri lama-ini tidak berubah.

Keterangan

Nama update-ini-section tertentu 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.

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.

Nama file apa pun yang ditentukan dalam entri ini-lama atau entri-ini-baru harus menunjuk direktori tujuan yang berisi file tersebut. Jalur direktori tujuan seperti itu dari nama file dalam entri update-ini-section harus ditentukan sebagai dirid. Untuk daftar nilai yang memungkinkan, lihat Menggunakan Dirids.