Bagian Inf DefaultInstall

Catatan

Jika Anda membangun paket driver universal, bagian ini hanya valid jika memiliki dekorasi arsitektur, misalnya [DefaultInstall.NTAMD64].

Catatan

Menggunakan bagian DefaultInstall dan Manufacturer di INF Anda akan menyebabkan kegagalan validasi INF Universal dan dapat menyebabkan perilaku penginstalan yang tidak konsisten. Lihat Menggunakan File INF Universal.

Bagian DefaultInstall file INF diakses jika pengguna memilih item menu "Instal" setelah memilih dan menahan (atau mengklik kanan) pada nama file INF. Pada versi windows Windows 10 1903 dan yang lebih baru, INF dengan DefaultInstall dapat digunakan dalam banyak API paket driver jika memenuhi persyaratan driver primitif.

[DefaultInstall] | 
[DefaultInstall.nt] | 
[DefaultInstall.ntx86] | 
[DefaultInstall.ntia64] | (Windows XP and later versions of Windows)
[DefaultInstall.ntamd64] | (Windows XP and later versions of Windows)
[DefaultInstall.ntarm] | (Windows 8 and later versions of Windows)
[DefaultInstall.ntarm64] (Windows 10 version 1709 and later versions of Windows)
 
[CopyFiles=@filename | file-list-section[,file-list-section] ...]
[CopyINF=filename1.inf[,filename2.inf]...]
[AddReg=add-registry-section[,add-registry-section]...]
[Include=filename1.inf[,filename2.inf]...]
[Needs=inf-section-name[,inf-section-name]...]
[Delfiles=file-list-section[,file-list-section]...]
[Renfiles=file-list-section[,file-list-section]...]
[DelReg=del-registry-section[,del-registry-section]...]
[BitReg=bit-registry-section[,bit-registry-section]...]
[ProfileItems=profile-items-section[,profile-items-section]...]
[UpdateInis=update-ini-section[,update-ini-section]...]
[UpdateIniFields=update-inifields-section[,update-inifields-section]...]
[Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...]
[RegisterDlls=register-dll-section[,register-dll-section]...]
[UnregisterDlls=unregister-dll-section[,unregister-dll-section]...] ...

Entri

Tidak semua entri yang valid didukung dalam UNIVERSAL INF. Berikut ini daftar direktif mana yang valid dalam INF universal dan yang tidak.

Didukung dalam Universal INF

CopyFiles=@filename | file-list-section[,file-list-section] ...
Direktif opsional ini menentukan satu file bernama untuk disalin dari media sumber ke tujuan, atau mereferensikan satu atau beberapa bagian yang ditentukan penulis INF yang menentukan file yang akan ditransfer dari media sumber ke tujuan.

Entri DefaultDestDir di bagian DestinationDirs dari INF menentukan tujuan untuk setiap file tunggal yang akan disalin. Bagian SourceDisksNames dan SourceDisksFiles , atau INF tambahan yang ditentukan di entri LayoutFile dari bagian Versi INF ini, berikan lokasi di media distribusi file driver.

Untuk informasi selengkapnya, lihat Direktif INF CopyFiles.

CopyINF=filename1.inf[,filename2.inf]...
(Windows XP dan versi Windows yang lebih baru.) Arahan ini menyebabkan file INF tertentu disalin ke sistem target.

Untuk informasi selengkapnya, lihat Direktif INF CopyINF.

AddReg=add-registry-section[,add-registry-section]...
Direktif ini mereferensikan satu atau beberapa bagian yang ditentukan inf-writer di mana subkey baru, mungkin dengan entri nilai awal, ditentukan untuk ditulis ke dalam registri atau di mana entri nilai kunci yang ada dimodifikasi.

Untuk informasi selengkapnya, lihat Direktif AddReg INF.

Include=filename1.inf[,filename2.inf]...
Entri opsional ini menentukan satu atau beberapa file INF tambahan yang disediakan sistem yang berisi bagian yang diperlukan untuk menginstal perangkat dan/atau driver ini. Jika entri ini ditentukan, biasanya begitu juga entri Kebutuhan .

Misalnya, file INF sistem untuk driver perangkat yang bergantung pada dukungan kernel-streaming sistem menentukan entri ini sebagai berikut:

Include= ks.inf,kscaptur.inf,ksfilter.inf

Needs=inf-section-name[,inf-section-name]...
Entri opsional ini menentukan bagian dalam file INF yang disediakan sistem yang harus diproses selama penginstalan perangkat ini. Biasanya, bagian bernama seperti itu adalah DDInstall (atau DDInstall.bagian xxx) dalam salah satu file INF yang tercantum dalam entri Sertakan . Namun, ini bisa menjadi bagian apa pun yang dirujuk dalam DDInstall atau DDInstall seperti itu.bagian xxx dari INF yang disertakan.

Misalnya, file INF untuk driver perangkat yang memiliki entri Sertakan sebelumnya tentukan entri ini sebagai berikut:

Needs= KS.Registration,KSCAPTUR.Registration.NT,MSPCLOCK.Installation

Tidak didukung dalam Universal INF

Delfiles=file-list-section[,file-list-section]...
Direktif ini mereferensikan satu atau beberapa bagian yang ditentukan inf-writer yang mencantumkan file pada target yang akan dihapus.

Untuk informasi selengkapnya, lihat Direktif INF DelFiles.

Renfiles=file-list-section[,file-list-section]...
Direktif ini mereferensikan satu atau beberapa bagian yang ditentukan inf-writer yang mencantumkan file yang akan diganti namanya pada tujuan sebelum file sumber yang relevan dengan perangkat disalin ke komputer target.

Untuk informasi selengkapnya, lihat Inf RenFiles Directive.

DelReg=del-registry-section[,del-registry-section]...
Direktif ini mereferensikan satu atau beberapa bagian yang ditentukan inf-writer di mana kunci dan/atau entri nilai ditentukan untuk dihapus dari registri selama penginstalan perangkat.

Untuk informasi selengkapnya, lihat Direktif INF DelReg.

BitReg=bit-registry-section[,bit-registry-section]...
Direktif ini mereferensikan satu atau beberapa bagian yang ditentukan inf-writer di mana entri nilai registri yang ada dari jenis REG_BINARY dimodifikasi. Untuk informasi selengkapnya, lihat Direktif AddReg INF.

Untuk informasi selengkapnya, lihat InF BitReg Directive.

ProfileItems=profile-items-section[,profile-items-section]...
Direktif ini mereferensikan satu atau beberapa bagian yang ditentukan penulis INF yang menjelaskan item yang akan ditambahkan, atau dihapus dari, menu Mulai.

Untuk informasi selengkapnya, lihat Inf ProfileItems Directive.

UpdateInis=update-ini-section[,update-ini-section]...
Ini jarang digunakan direktif mereferensikan satu atau beberapa bagian yang ditentukan INF-writer, menentukan file INI sumber tempat bagian atau baris tertentu dalam bagian tersebut akan dibaca ke dalam file INI tujuan dengan nama yang sama selama penginstalan. Secara opsional, modifikasi baris demi baris ke file INI yang ada di tujuan dari file INI sumber tertentu dengan nama yang sama dapat ditentukan di bagian update-ini.

Untuk informasi selengkapnya, lihat Direktif INF UpdateInis.

UpdateIniFields=update-inifields-section[,update-inifields-section]...
Direktif yang jarang digunakan ini mereferensikan satu atau beberapa bagian yang ditentukan inf-writer di mana modifikasi dalam baris file INI khusus perangkat ditentukan.

Untuk informasi selengkapnya, lihat InF UpdateIniFields Directive.

Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...
Ini jarang digunakan direktif mereferensikan satu atau beberapa bagian yang ditentukan INF-writer di mana bagian atau baris dari file INI khusus perangkat, yang disediakan di media sumber, akan dipindahkan ke registri.

Untuk informasi selengkapnya, lihat Direktif INF Ini2Reg.

RegisterDlls=register-dll-section[,register-dll-section]...
Direktif ini mereferensikan satu atau beberapa bagian INF yang digunakan untuk menentukan file yang merupakan kontrol OLE dan memerlukan pendaftaran mandiri.

Untuk informasi selengkapnya, lihat Direktif INF RegisterDlls.

UnregisterDlls=unregister-dll-section[,unregister-dll-section]...
Direktif ini mereferensikan satu atau beberapa bagian INF yang digunakan untuk menentukan file yang merupakan kontrol OLE dan memerlukan pembebasan pendaftaran mandiri (penghapusan mandiri).

Untuk informasi selengkapnya, lihat Direktif INF UnregisterDlls.

Keterangan

Bagian DefaultInstall tidak boleh digunakan untuk penginstalan perangkat. Gunakan bagian DefaultInstall hanya untuk penginstalan driver filter kelas, filter sistem file, dan layanan driver kernel yang tidak terkait dengan node perangkat (devnode).

Jika menggunakan DefaultInstall pada windows versi Windows 10 1903 dan yang lebih baru, disarankan agar file INF memenuhi persyaratan driver primitif.

Catatan

File INF dari paket driver yang memiliki bagian Produsen tidak boleh berisi bagian INF DefaultInstall jika paket driver akan ditandatangani secara digital. Untuk informasi selengkapnya tentang menandatangani paket driver, lihat Penandatanganan Driver.

Catatan

Tidak seperti bagian DDInstall , bagian DefaultInstall tidak dapat berisi direktif DriverVer atau LogConfig .

Untuk menginstal bagian DefaultInstall dari aplikasi penginstalan perangkat, gunakan panggilan berikut ke InstallHinfSection:

InstallHinfSection(NULL,NULL,TEXT("DefaultInstall 132 path-to-inf\infname.inf"),0); 

Untuk informasi selengkapnya tentang cara menggunakan ekstensi .nt, .ntx86, .ntia64, .ntamd64, .ntarm, dan .ntarm64 yang ditentukan sistem, lihat Membuat File INF untuk Beberapa Platform dan Sistem Operasi.

Contoh

Contoh berikut menunjukkan bagian DefaultInstall yang khas:

[DefaultInstall]
CopyFiles=MyAppWinFiles, MyAppSysFiles, @SRSutil.exe
AddReg=MyAppRegEntries

Lihat juga

DDInstall

DriverVer

LogConfig