Bagian Inf DefaultInstall

Nota

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

Nota

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 Windows 10 versi 1903 dan versi Windows 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 mencantumkan arahan mana yang valid dalam INF universal dan mana yang tidak.

Didukung dalam Universal INF

CopyFiles=@filename | file-list-section[,file-list-section] ...
Direktif opsional ini menentukan satu file bernama yang akan 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 dalam entri LayoutFile dari bagian Versi INF ini, menyediakan lokasi pada 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 demikian 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, itu bisa menjadi bagian apa pun yang dirujuk dalam DDInstall atau DDInstallseperti itu.bagian xxx dari INF yang disertakan.

Misalnya, file INF untuk driver perangkat yang memiliki entri Sertakan sebelumnya menentukan 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 Direktif RenFiles INF.

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 Direktif INF BitReg.

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

Untuk informasi selengkapnya, lihat Direktif INF ProfileItems.

UpdateInis=update-ini-section[,update-ini-section]...
Direktif yang jarang digunakan ini 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 Direktif INF UpdateIniFields.

Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...
Direktif yang jarang digunakan ini 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 unregistrasi mandiri (penghapusan sendiri).

Untuk informasi selengkapnya, lihat Direktif INF UnregisterDlls.

Remarks

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 simpul perangkat (devnode).

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

Nota

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 penandatanganan paket driver, lihat Penandatanganan Driver.

Nota

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.

Examples

Contoh berikut menunjukkan bagian DefaultInstall umum:

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

Baca juga

DDInstall

DriverVer

LogConfig