Direktif INF DelProperty

Perhatian

Jika Anda membangun paket Driver universal atau Windows, arahan ini tidak valid. Lihat Menggunakan File INF Universal dan Memulai Driver Windows.

Direktif DelProperty mereferensikan satu atau beberapa bagian file INF yang menghapus properti perangkat untuk instans perangkat, kelas penyiapan perangkat, kelas antarmuka perangkat, atau antarmuka perangkat.

[DDInstall] | 
[DDInstall.CoInstallers] | 
[ClassInstall32] | 
[ClassInstall32.ntx86] | 
[ClassInstall32.ntia64] | (Windows XP and later versions of Windows)
[ClassInstall32.ntamd64] | (Windows XP and later versions of Windows)
[ClassInstall32.ntarm] | (Windows 8 and later versions of Windows)
[ClassInstall32.ntarm64] | (Windows 10 version 1709 and later versions of Windows)
[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 version 1709 and later versions of Windows)
[add-interface-section] 
 
DelProperty=del-property-section[,del-property-section]... (Windows Vista and later versions of Windows)

Direktif DelProperty dapat ditentukan di bawah salah satu bagian yang ditunjukkan dalam pernyataan sintaks formal di atas.

Del-property-section yang direferensikan oleh direktif DelProperty memiliki format berikut:

[del-property-section]
(property-name [ ,, flags [, value]]) | ({property-category-guid}, property-pid [ , flags [, value]])
(property-name [ ,, flags [, value]]) | ({property-category-guid}, property-pid [ , flags [, value]])
...

Del-property-section dapat memiliki sejumlah entri nama properti atau entri property-guid, masing-masing pada baris terpisah.

Entri

property-name
Salah satu nama properti yang mewakili properti paket driver instans perangkat. Nama properti yang didukung sama dengan yang dijelaskan untuk entri nama properti dari arahan ADDProperty INF.

property-category-guid
Nilai GUID yang mengidentifikasi kategori properti. Nilai GUID dapat menjadi GUID yang ditentukan sistem yang mengidentifikasi kategori properti yang ditentukan sistem atau GUID kustom yang mengidentifikasi kategori properti kustom. Nilai GUID yang didukung sama dengan yang dijelaskan untuk entri property-category-guid dari arahan INF AddProperty .

property-pid
Pengidentifikasi properti yang menunjukkan properti tertentu dalam kategori properti yang ditunjukkan oleh nilai property-category-guid . Untuk alasan sistem internal, pengidentifikasi properti harus lebih besar dari atau sama dengan dua.

Bendera
Nilai bendera heksadesimal opsional yang mengontrol operasi penghapusan. Satu-satunya nilai bendera yang didukung adalah sebagai berikut:

0x00000001 (FLG_DELPROPERTY_MULTI_SZ_DELSTRING)
Jika jenis data properti DEVPROP_TYPE_STRING_LIST, operasi akan menghapus semua string dengan daftar string yang ada yang cocok dengan string yang disediakan oleh nilai entri nilai. Kasus karakter tidak dipertimbangkan dalam perbandingan antara string yang disediakan dan string yang ada dalam daftar string.

nilai
Jika jenis data properti DEVPROP_TYPE_STRING_LIST dan entri bendera 0x00000001, nilai entri nilai memasok string yang digunakan operasi penghapusan untuk mencari string yang cocok di daftar string yang ada dan, jika string yang cocok ditemukan, operasi penghapusan menghapus string yang cocok dari daftar string yang ada.

Keterangan

Secara umum, file INF tidak boleh digunakan untuk menghapus properti perangkat yang mungkin diatur oleh komponen sistem atau oleh file INF lainnya. Tujuan utama direktif DelProperty adalah untuk digunakan dalam file INF yang memperbarui penginstalan perangkat sebelumnya dan properti yang diatur untuk penginstalan perangkat sebelumnya tidak lagi diperlukan.

Nama del-property-section harus unik dalam file INF, tetapi nama bagian dapat direferensikan oleh lebih dari satu direktif DelPropertydalam file INF yang sama. Nama bagian harus mengikuti aturan umum untuk menentukan nama bagian yang dijelaskan dalam Aturan Sintaks Umum untuk File INF.

Untuk informasi selengkapnya tentang cara menggunakan direktif DelProperty , lihat Menggunakan Direktif AddProperty INF dan Direktif INF DelProperty.

Contoh

Contoh bagian properti hapus berikut ini mencakup dua entri baris: entri baris pertama menyertakan nilai entri nama properti yang menghapus properti DeviceModel , dan entri baris kedua menghapus string "DeleteThisString" dari nilai properti perangkat kustom yang jenis datanya DEVPROP_TYPE_STRING_LIST. Di baris kedua, nilai entri property-category-guid adalah "c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e," nilai entri pengidentifikasi properti adalah "2," dan nilai entri bendera adalah "0x00000001,"

[SampleDelPropertySection]
DeviceModel
{c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e}, 2, 0x00000001, "DeleteThisString"

Lihat juga

AddProperty