Bagian INF DDInstall.HW

  • Artikel

DDInstall. Bagian HW biasanya digunakan untuk menginstal perangkat multifungsi, untuk menginstal driver filter PnP, dan untuk menyiapkan informasi khusus perangkat khusus tetapi independen driver yang dapat diakses pengguna di registri, baik dengan arahan AddReg eksplisit atau dengan entri Sertakan dan Perlu .

[install-section-name.HW] |
[install-section-name.nt.HW] |
[install-section-name.ntx86.HW] |
[install-section-name.ntia64.HW] | (Windows XP and later versions of Windows)
[install-section-name.ntamd64.HW] | (Windows XP and later versions of Windows)
[install-section-name.ntarm.HW] | (Windows 8 and later versions of Windows)
[install-section-name.ntarm64.HW] (Windows 10 version 1709 and later versions of Windows)
 
[AddReg=add-registry-section[,add-registry-section]...] ...
[Include=filename.inf[,filename2.inf]...]
[Needs=inf-section-name[,inf-section-name]...]
[DelReg=del-registry-section[,del-registry-section]...] ...
[BitReg=bit-registry-section[,bit-registry-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

AddReg=add-registry-section[,add-registry-section]...
Mereferensikan satu atau beberapa inf-writer-defined add-registry-sections di tempat lain dalam file INF untuk perangkat yang dicakup oleh DDInstall ini. Bagian HW . Bagian add-registry biasanya menginstal filter dan/atau menyimpan informasi per perangkat di registri. Spesifikasi HKR di bagian add-registry tersebut menentukan kunci perangkat keras perangkat, subkunci registri khusus perangkat yang berisi informasi tentang perangkat. Kunci perangkat keras juga disebut kunci perangkat. Untuk informasi selengkapnya, lihat Pohon dan Kunci Registri untuk Perangkat dan Driver. Paket driver dapat menambahkan pengaturan melalui INF dengan menggunakan spesifikasi HKR di bagian add-registry yang direferensikan oleh bagian DDInstall.HW.

Untuk informasi selengkapnya, lihat Direktif AddReg INF.

Include=filename. inf[,filename2.inf]...
Menentukan satu atau beberapa berkas INF tambahan yang disediakan sistem yang memuat bagian yang diperlukan untuk menginstal perangkat ini. Jika entri ini ditentukan, biasanya begitu juga entri Kebutuhan .

Needs=inf-section-name[,inf-section-name]...
Menentukan bagian bernama yang harus diproses selama penginstalan perangkat ini. Biasanya, bagian bernama seperti itu adalah DDInstall. Bagian HW dalam file INF yang disediakan sistem yang tercantum dalam entri Sertakan . Namun, ini bisa menjadi bagian apa pun yang dirujuk dalam DDInstall seperti itu. Bagian HW dari INF yang disertakan.

Tidak didukung dalam Universal INF

DelReg=del-registry-section[,del-registry-section]...
Mereferensikan satu atau beberapa inf-writer-defined delete-registry-sections di tempat lain dalam file INF untuk driver perangkat yang dicakup oleh bagian DDInstall ini. Bagian delete-registry seperti itu menghapus informasi registri kedaluarsa untuk perangkat/driver yang diinstal sebelumnya dari komputer target. Spesifikasi HKR di bagian delete-registry tersebut menunjuk subkey yang sama seperti untuk AddReg.

Direktif ini jarang digunakan, kecuali dalam file INF yang meningkatkan penginstalan sebelumnya dari perangkat/model yang sama yang tercantum di bagian per produsen per Model yang menentukan nama bagian DDInstall ini. Untuk informasi selengkapnya, lihat Direktif INF DelReg.

BitReg=bit-registry-section[,bit-registry-section] ...
Valid di bagian ini, tetapi hampir tidak pernah digunakan. Spesifikasi HKR di bagian bit-registri yang direferensikan menunjuk subkuntang yang sama seperti untuk AddReg. Untuk informasi selengkapnya, lihat InF BitReg Directive.

Keterangan

Ekstensi yang tidak peka huruf besar/kecil ke nama bagian penginstalan yang ditunjukkan dalam pernyataan sintaks formal dapat dimasukkan ke dalam DDInstall seperti itu. Nama bagian HW dalam file INF lintas platform. 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.

Setiap DDInstall. Bagian HW harus memiliki salah satu hal berikut ini:

  • Direktif AddReg.
  • Entri Sertakan yang menentukan file INF lain. Dalam hal ini, DDInstall. Bagian HW juga harus berisi entri Kebutuhan yang sesuai yang menentukan bagian dalam file INF lainnya. Bagian ini digunakan untuk menyiapkan informasi registri yang diperlukan.

Setiap arahan dalam DDInstall. Bagian HW dapat mereferensikan lebih dari satu bagian yang ditentukan penulis INF. Namun, setiap bagian bernama tambahan harus dipisahkan dari bagian berikutnya dengan koma (,).

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

Untuk informasi selengkapnya tentang cara menginstal perangkat multifungsi, lihat Mendukung Perangkat Multifungsi.

Contoh

Contoh ini menunjukkan bagaimana paket driver dapat menggunakan DDInstall. Bagian HW dan DDInstall. Bagian layanan untuk menambahkan driver fungsi dan driver filter atas PnP.

[Example_DDInstall]
CopyFiles=example_copyfiles

[Example_DDInstall.HW]
AddReg=filter_addreg

[filter_addreg]
HKR,,"UpperFilters",0x00010000,"ExampleUpperFilter" ; [REG_MULTI_SZ](https://learn.microsoft.com/windows/desktop/SysInfo/registry-value-types) value 

[Example_DDInstall.Services]
AddService=ExampleFunctionDriver,0x00000002,function_ServiceInstallSection
AddService=ExampleUpperFilter,,filter_ServiceInstallSection

[function_ServiceInstallSection]
DisplayName    = %function_ServiceDesc%
ServiceType    = 1
StartType      = 3
ErrorControl   = 1
ServiceBinary  = %13%\ExampleFunctionDriver.sys

[filter_ServiceInstallSection]
DisplayName    = %filter_ServiceDesc%
ServiceType    = 1
StartType      = 3
ErrorControl   = 1
ServiceBinary  = %13%\ExampleUpperFilter.sys

Lihat juga

AddReg

BitReg

DDInstall

DDInstall.Services

DelReg