Bagian INF DDInstall

Artikel
06/14/2023

Setiap bagian DDInstall per Model berisi direktif DriverVer opsional dan satu atau beberapa direktif yang merujuk bagian bernama tambahan dalam file INF, yang ditunjukkan di sini dengan arahan INF yang paling sering ditentukan, CopyFiles dan AddReg, tercantum terlebih dahulu.

Bagian yang direferensikan oleh direktif ini berisi instruksi untuk menginstal file driver dan menulis informasi khusus perangkat dan/atau khusus driver ke dalam registri.

[install-section-name] | 
[install-section-name.nt] | 
[install-section-name.ntx86] | 
[install-section-name.ntia64] | (Windows XP and later versions of Windows)
[install-section-name.ntamd64] | (Windows XP and later versions of Windows)
[install-section-name.ntarm] | (Windows 8 and later versions of Windows)
[install-section-name.ntarm64] (Windows 10 version 1709 and later versions of Windows)

[DriverVer=mm/dd/yyyy[,x.y.v.z]]
[CopyFiles=@filename | file-list-section[,file-list-section] ...]
[CopyINF=filename1.inf[,filename2.inf]...] (Windows XP and later versions of Windows)
[AddReg=add-registry-section[,add-registry-section]...]
[AddProperty=add-property-section[,add-property-section]...] (Windows Vista and later versions of Windows)
[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]...]
[DelProperty=del-property-section[,del-property-section]...] (Windows Vista and later versions of Windows)
[FeatureScore=featurescore]... (Windows Vista and later versions of Windows)
[BitReg=bit-registry-section[,bit-registry-section]...]
[LogConfig=log-config-section[,log-config-section]...]
[ProfileItems=profile-items-section[,profile-items-section]...] (Windows 2000 and later versions of Windows)
[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]...]
[ExcludeID=device-identification-string[,device-identification-string]...]... ((Windows XP and later versions of Windows)
[Reboot]

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

DriverVer=mm/dd/yyyy[,x.y.v.z]
Entri opsional ini menentukan informasi versi untuk paket driver.

Untuk informasi tentang cara menentukan entri ini, lihat Petunjuk DriverVer INF.

CopyFiles=@filename | file-list-section[,file-list-section] ...
Arahan ini menentukan satu file bernama untuk disalin dari media sumber ke tujuan atau mereferensikan satu atau beberapa bagian yang ditentukan penulis INF di mana file yang relevan dengan perangkat pada media sumber ditentukan untuk ditransfer ke tujuan. Direktif CopyFiles bersifat opsional, tetapi ada di sebagian besar bagian DDInstall .

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 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.

Spesifikasi HKR di bagian add-registry seperti itu menunjuk jalur registri "kunci perangkat lunak" dari perangkat yang sedang diinstal.

Untuk informasi selengkapnya, lihat Direktif AddReg INF.

AddProperty=add-property-section[,add-property-section]...
(Windows Vista dan yang lebih baru) Mereferensikan satu atau beberapa bagian file INF yang memodifikasi properti perangkat yang diatur untuk instans perangkat. Anda harus menggunakan direktif AddProperty INF hanya untuk mengatur properti instans perangkat yang baru untuk Windows Vista atau versi sistem operasi Windows yang lebih baru.

Untuk properti instans perangkat yang diperkenalkan sebelumnya di Windows Server 2003, Windows XP, atau Windows 2000, dan yang memiliki nilai entri registri yang sesuai, Anda harus terus menggunakan arahan INF AddReg untuk mengatur properti instans perangkat. Panduan ini berlaku untuk properti yang ditentukan sistem dan properti kustom. Untuk informasi selengkapnya tentang cara menggunakan direktif AddProperty , lihat Menggunakan Direktif AddProperty INF dan Direktif INF DelProperty.

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 untuk driver perangkat yang bergantung pada dukungan kernel-streaming sistem dapat 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 dapat menentukan entri ini sebagai berikut:

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

FeatureScore=featurescore

Peringatan

Direktif FeatureScore hanya diproses ketika ditentukan langsung di bagian [DDInstall].

(Windows Vista dan yang lebih baru) Arahan ini memberikan kriteria peringkat tambahan untuk driver yang didasarkan pada fitur yang didukung driver. Misalnya, skor fitur mungkin ditentukan untuk kelas penyiapan perangkat yang membedakan antara driver berdasarkan kriteria khusus kelas.

Untuk informasi selengkapnya tentang bagaimana driver diberi peringkat, lihat Bagaimana Windows Ranks Drivers (Windows Vista dan Later).

Untuk informasi selengkapnya tentang arahan ini, lihat Direktif INF FeatureScore.

Catatan

Meskipun bagian DDInstall dapat berisi beberapa entri FeatureScore , hanya entri pertama yang diproses untuk bagian tersebut.

ExcludeID=device-identification-string[,device-identification-string]...

Peringatan

Direktif ExcludeID hanya diproses ketika ditentukan langsung di bagian [DDInstall].

(Windows XP dan yang lebih baru) Direktif ini menentukan satu atau beberapa string identifikasi perangkat (ID perangkat keras atau ID yang kompatibel). Bagian DDInstall tidak menginstal perangkat yang memiliki ID perangkat yang cocok dengan ID perangkat keras atau ID yang kompatibel yang tercantum.

Reboot
Direktif ini menunjukkan bahwa penelepon harus diminta untuk me-reboot sistem setelah penginstalan selesai.

Untuk informasi selengkapnya, lihat Direktif Reboot INF.

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.

Biasanya, arahan ini digunakan untuk menangani peningkatan ketika INF harus membersihkan entri registri lama dari penginstalan perangkat ini sebelumnya.

Spesifikasi HKR di bagian delete-registry tersebut menunjuk jalur registri "kunci perangkat lunak" dari perangkat yang sedang diinstal.

Untuk informasi selengkapnya, lihat Direktif INF DelReg.

DelProperty=del-property-section[,del-property-section]...
(Windows Vista dan yang lebih baru) Mereferensikan satu atau beberapa bagian file INF yang menghapus properti perangkat yang diatur untuk instans perangkat. Anda harus menggunakan direktif INF DelProperty hanya untuk menghapus properti instans perangkat yang baru untuk Windows Vista atau versi Windows yang lebih baru.

Untuk properti instans perangkat yang diperkenalkan sebelumnya di Windows Server 2003, Windows XP, atau Windows 2000, dan yang memiliki nilai entri registri yang sesuai, Anda harus terus menggunakan arahan INF DelReg untuk menghapus properti instans perangkat. Panduan ini berlaku untuk properti yang ditentukan sistem dan properti kustom. Untuk informasi selengkapnya tentang cara menggunakan direktif DelProperty , lihat Menggunakan Direktif AddProperty INF dan Direktif INF DelProperty.

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.

Spesifikasi HKR di bagian registri bit seperti itu menunjuk jalur registri "kunci perangkat lunak" dari perangkat yang sedang diinstal.

Untuk informasi selengkapnya, lihat InF BitReg Directive.

LogConfig=log-config-section[,log-config-section]...
Arahan ini mereferensikan satu atau beberapa bagian yang ditentukan inf-writer dalam INF untuk perangkat root-enumerated atau untuk perangkat yang diinstal secara manual. Di bagian bernama ini, INF untuk perangkat yang "terdeteksi" atau diinstal secara manual menentukan satu atau beberapa konfigurasi logis sumber daya perangkat keras relatif bus yang harus beroperasi oleh perangkat. INF untuk perangkat yang diinstal secara manual yang tidak dapat dikonfigurasi perangkat lunak juga harus memiliki DDInstall. Bagian FactDef .

Direktif LogConfig tidak pernah digunakan untuk menginstal perangkat Plug and Play (PnP). Namun, Anda dapat menggunakan bagian INF DDInstall.LogConfigOverride untuk menyediakan konfigurasi penimpaan untuk perangkat PnP.

Arahan ini tidak relevan dengan semua driver dan komponen tingkat yang lebih tinggi (nondevice).

Untuk informasi selengkapnya, lihat Direktif LogConfig INF.

ProfileItems=profile-items-section[,profile-items-section]...
(Microsoft Windows 2000 dan versi Windows yang lebih baru) Direktif yang jarang digunakan 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 unregistrasi mandiri (penghapusan mandiri).

Untuk informasi selengkapnya, lihat Direktif INF UnregisterDlls.

Keterangan

Sepanjang dokumentasi Windows Driver Kit (WDK), istilah DDInstall digunakan untuk merujuk ke nama bagian penginstalan, dengan atau tanpa ekstensi platform. Oleh karena itu, "bagian DDInstall" berarti "bagian bernama dalam INF, memiliki format [install-section-name] atau [install-section-name.ntxxx]". Saat Membuat nama untuk bagian DDInstall , Anda harus menyertakan awalan khusus perangkat, seperti [WDMPNPB003_Device] atau [GPR400. Pasang.NT].

Setiap bagian DDInstall harus dirujuk dalam entri khusus perangkat/model di bawah bagian Model INF per produsen dari file INF.

Kecuali untuk perangkat yang tidak memiliki file terkait yang akan ditransfer dari media sumber, file INF yang menginstal driver WDM pada platform sistem operasi yang berbeda harus memiliki setidaknya salah satu bagian DDInstall berikut:

Bagian install-section-name.ntx86 yang menentukan entri untuk penginstalan perangkat/driver khusus untuk platform berbasis x86.
Bagian install-section-name.ntia64 yang menentukan entri untuk penginstalan perangkat/driver khusus untuk platform berbasis Itanium.
Bagian install-section-name.ntamd64 yang menentukan entri untuk penginstalan perangkat/driver khusus untuk platform berbasis x64.
Bagian install-section-name.ntarm yang menentukan entri untuk penginstalan perangkat/driver khusus untuk platform berbasis Arm.
Bagian install-section-name.ntarm64 yang menentukan entri untuk penginstalan perangkat/driver khusus untuk platform berbasis Arm64.
Bagian install-section-name atau install-section-name.nt yang menentukan entri untuk penginstalan perangkat/driver yang tidak spesifik untuk platform perangkat keras tertentu.

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.

Dimulai dengan Windows 2000, file INF yang menginstal driver harus memiliki bagian DDInstall.Services untuk menentukan informasi layanan driver.

Setiap direktif di bagian DDInstall dapat mereferensikan lebih dari satu nama bagian. Namun, setiap bagian bernama tambahan harus dipisahkan dari bagian berikutnya dengan koma (,).

Setiap nama bagian 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.

Setiap direktif AddReg yang ditentukan dalam bagian DDInstall diasumsikan untuk mereferensikan bagian add-registry yang tidak dapat digunakan untuk menyimpan informasi tentang driver filter atas atau bawah, tentang perangkat multifungsi, atau tentang parameter independen driver tetapi khusus perangkat. Jika INF perangkat/driver harus menyimpan jenis informasi ini dalam registri, perangkat harus menggunakan direktif AddReg dalam DDInstall yang tidak terdekorasi dan didekorasi. Bagian HW, jika ada, untuk mereferensikan bagian add-registry yang ditentukan inf-writer lainnya.

Bergantung pada kelas penyiapan perangkat yang ditentukan di bagian Versi INF, arahan khusus kelas tambahan dapat ditentukan di bagian DDInstall . Untuk informasi selengkapnya tentang arahan khusus kelas, lihat topik berikut:

Contoh

Contoh ini menunjukkan perluasan bagian DDInstall , Ser_Inst dan Inp_Inst. Bagian ini dirujuk dalam contoh untuk bagian Model INF.

[Ser_Inst]
CopyFiles=Ser_CopyFiles, mouclass_CopyFiles

[Ser_CopyFiles]
sermouse.sys

[mouclass_CopyFiles] ; section name referenced by > 1 CopyFiles
mouclass.sys

[Inp_Inst]
CopyFiles=Inp_CopyFiles, mouclass_CopyFiles

[Inp_CopyFiles]
inport.sys

Contoh berikut menunjukkan bagian DDInstall dari file INF yang menginstal driver WDM yang disediakan sistem untuk perangkat audio pada berbagai platform sistem operasi:

[WDMPNPB003_Device.NT]
Include=ks.inf, wdmaudio.inf
Needs=KS.Registration, WDMAUDIO.Registration.NT
CopyFiles=MSSB16.CopyList
AddReg=WDM_SB16.AddReg

Contoh berikut menunjukkan bagian yang direferensikan oleh entri Kebutuhan sebelumnya dalam file ks.inf dan wdmaudio.inf yang disediakan sistem. Dalam contoh sebelumnya, file-file ini ditentukan dalam entri Sertakan . Ketika alat penginstal perangkat sistem operasi memproses nama bagian penginstalan perangkat ini. bagian nt , dua bagian berikutnya ini juga diproses.

[KS.Registration]
; following AddReg= is actually a single line in the ks.inf file
AddReg=ProxyRegistration,CategoryRegistration,\
    TopologyNodeRegistration,PlugInRegistration,PinNameRegistration,\
    DeviceRegistration 
CopyFiles=KSProxy.Files,KSDriver.Files

[WDMAUDIO.Registration.NT]
AddReg=WDM.AddReg
CopyFiles=WDM.CopyFiles.Sys, WDM.CopyFiles.Drv
;
; INF-writer-defined add-registry and file-list sections
; referenced by preceding directives are omitted here for brevity
;