Bagikan melalui

Bagian INF DDInstall

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

Bagian yang direferensikan oleh arahan 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 mencantumkan arahan mana yang valid dalam INF universal dan mana 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 yang akan 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 INF menentukan tujuan untuk setiap file tunggal yang akan disalin. Bagian SourceDisksNames dan SourceDisksFiles, atau INF tambahan yang ditentukan dalam entri LayoutFile bagian Versi INF ini, menyediakan lokasi pada media distribusi file driver.

Untuk informasi selengkapnya, lihat INF CopyFiles Directive.

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

Untuk informasi selengkapnya, lihatDirektif 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" yang diinstal.

Untuk informasi selengkapnya, lihat inf AddReg Directive.

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 INF AddProperty 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 pada Windows Server 2003, Windows XP, atau Windows 2000, dan yang memiliki nilai entri registri yang sesuai, Anda harus terus menggunakan direktif 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 Perlu.

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 bagian DDInstall (atau DDInstall.xxx) dalam salah satu file INF yang tercantum dalam entri Sertakan . Namun, itu bisa menjadi bagian apa pun yang dirujuk dalam DDInstall atau DDInstall.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= fitur

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 Inf FeatureScore Directive.

Nota

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 (baik 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
Arahan ini menunjukkan bahwa penelepon harus diminta untuk me-reboot sistem setelah penginstalan selesai.

Untuk informasi selengkapnya, lihat INF Reboot Directive.

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, lihatINF DelFiles Directive .

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 registri penghapusan seperti itu menunjuk "kunci perangkat lunak" jalur registri perangkat yang diinstal.

Untuk informasi selengkapnya, lihatInf DelReg Directive .

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 pada Windows Server 2003, Windows XP, atau Windows 2000, dan yang memiliki nilai entri registri yang sesuai, Anda harus terus menggunakan direktif 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 "kunci perangkat lunak" jalur registri perangkat yang diinstal.

Untuk informasi selengkapnya, lihat INF BitReg Directive.

LogConfig=log-config-section[,log-config-section]...
Direktif ini mereferensikan satu atau beberapa bagian yang ditentukan inf-writer dalam INF untuk perangkat yang dijumlahkan root 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. 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, lihatInf LogConfig Directive .

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]...
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 Inf UpdateInis Directive.

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-ke-registri-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 INF Ini2Reg Directive.

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, lihatDirektif 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, lihatDirektif INF UnregisterDlls .

Komentar

Sepanjang dokumentasi Windows Driver Kit (WDK), istilah DDInstall digunakan untuk merujuk ke install-section-name, 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 Anda membuat nama untuk bagian DDInstall, Anda harus menyertakan awalan khusus perangkat, seperti [WDMPNPB003_Device] atau [GPR400. Instal.NT].

Setiap bagian DDInstall harus dirujuk dalam entri khusus perangkat/model di bawah bagian Model INF per produsen 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 .ntyang ditentukan sistem , .ntx86, .ntia64, .ntamd64, .ntarm, dan ekstensi .ntarm64, 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 AddReg direktif 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 direktif DDInstall yang tidak terdekorasi dan didekorasi. Bagian HW, jika ada, untuk mereferensikan bagian add-registry-section lain.

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 file INF yang menginstal driver WDM yang disediakan sistem untuk perangkat audio di 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 yang disediakan sistem ks.in f dan file wdmaudio.inf. Dalam contoh sebelumnya, file-file ini ditentukan dalam entri Menyertakan. 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
;

Lihat juga

AddProperty

DDInstall. CoInstallers

DDInstall. FactDef

DDInstall. HW

DDInstall. Antarmuka

DDInstall. LogConfigOverride

DDInstall. Layanan

DefaultInstall

DefaultInstall.Services

DelProperty

FeatureScore

  • Last updated on