Bagian Inf InterfaceInstall32

Artikel
06/15/2023

Bagian ini membuat satu atau beberapa kelas antarmuka perangkat baru. Setelah kelas baru dibuat, perangkat/driver yang kemudian diinstal dapat mendaftarkan dukungan untuk kelas antarmuka perangkat baru dengan memanggil IoRegisterDeviceInterface.

[InterfaceInstall32]
 
{InterfaceClassGUID}=install-interface-section[,flags]
...

Entri

InterfaceClassGUID
Menentukan nilai GUID yang mengidentifikasi kelas antarmuka perangkat yang baru diekspor.

Untuk mendaftarkan instans kelas antarmuka, driver perangkat harus memanggil IoRegisterDeviceInterface dengan GUID ini. Nilai GUID yang ditentukan di bagian ini juga dapat direferensikan oleh direktif ADDInterface INF dalam INF DDInstall. Bagian antarmuka.

Untuk informasi selengkapnya tentang cara membuat GUID, lihat Menggunakan GUID di Driver. Untuk GUIDS kelas antarmuka yang ditentukan sistem, lihat header yang sesuai, seperti Ks.h untuk antarmuka kernel-streaming.

install-interface-section
Mereferensikan bagian yang ditentukan inf-writer, mungkin dengan salah satu ekstensi yang ditentukan sistem, di tempat lain dalam INF ini.

Bendera
Jika ditentukan, entri ini harus nol.

Keterangan

Ketika InterfaceClassGUID yang ditentukan belum diinstal dalam sistem, kelas antarmuka tersebut diinstal sebagai DDInstall yang sesuai. Bagian Antarmuka diproses selama penginstalan perangkat atau ketika driver perangkat tersebut melakukan panggilan awal ke IoRegisterDeviceInterface.

Setiap nama bagian install-interface 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 install-interface-section yang ditentukan memiliki formulir umum berikut:

[interface-install-section] | 
[interface-install-section.nt] | 
[interface-install-section.ntx86] | 
[interface-install-section.ntia64] | (Windows XP and later versions of Windows)
[interface-install-section.ntamd64] | (Windows XP and later versions of Windows)
[interface-install-section.ntarm] | (Windows 8 and later versions of Windows)
[interface-install-section.ntarm64] (Windows 10 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)
[Copyfiles=@filename | 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)
[BitReg=bit-registry-section[,bit-registry-section]...]
[Delfiles=file-list section[, file-list-section] ...]
[Renfiles=file-list-section[, file-list-section] ...]
[UpdateInis=update-ini-section[,update-ini-section]...]
[UpdateIniFields=update-inifields-section[,update-inifields-section]...]
[Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...]
...

Untuk informasi selengkapnya tentang entri di bagian penginstalan antarmuka, lihat Bagian Instalan INF DD.

Dimulai dengan Windows Vista, Anda dapat mengatur properti kelas antarmuka perangkat dengan menyertakan arahan INF AddProperty di bagian penginstalan antarmuka. Anda juga dapat menghapus properti kelas antarmuka perangkat dengan menyertakan arahan INF DelProperty di bagian penginstalan antarmuka. Namun, Anda harus menggunakan direktif AddProperty atau DelProperty hanya untuk memodifikasi properti kelas antarmuka perangkat yang baru untuk Windows Vista atau versi sistem operasi Windows yang lebih baru. Untuk properti kelas antarmuka perangkat yang diperkenalkan pada Windows Server 2003, Windows XP, atau Windows 2000, dan yang memiliki entri nilai registri yang sesuai, Anda harus terus menggunakan arahan INF AddReg dan arahan INF DelReg untuk mengatur dan menghapus properti kelas antarmuka perangkat. Panduan ini berlaku untuk properti yang ditentukan sistem dan properti kustom. Untuk informasi selengkapnya tentang cara menggunakan direktif AddProperty dan direktif DelProperty , lihat Menggunakan Direktif AddProperty INF dan Direktif INF DelProperty.

Direktif AddReg mereferensikan satu atau beberapa bagian add-registry yang mengatur informasi khusus antarmuka perangkat di registri selama penginstalan antarmuka ini.

Informasi registri tentang kelas antarmuka ini harus menyertakan setidaknya nama yang ramah untuk kelas antarmuka perangkat baru dan informasi apa pun yang dibutuhkan komponen tingkat yang lebih tinggi ketika mereka membuka dan menggunakan antarmuka ini.

Selain itu, bagian antarmuka penginstalan seperti itu mungkin menggunakan salah satu arahan opsional yang ditunjukkan di sini untuk menentukan operasi penginstalan khusus antarmuka.

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