Bagikan melalui

Menggunakan Direktif AddProperty INF dan Direktif INF DelProperty

  • Artikel

Di Windows Vista dan versi Windows yang lebih baru, Anda dapat menggunakan direktif INF AddProperty dan direktif INF DelProperty untuk mengatur dan menghapus properti untuk instans perangkat, kelas penyiapan perangkat, kelas antarmuka perangkat, dan antarmuka perangkat. Ini termasuk properti perangkat yang ditentukan sistem dan properti perangkat kustom. Namun, Anda harus menggunakan panduan berikut saat menggunakan direktif AddProperty dan DelProperty alih-alih arahan INF AddReg dan arahan INF DelReg untuk mengatur dan menghapus properti perangkat:

  • Untuk properti perangkat yang diperkenalkan pada Windows Vista dan versi Windows yang lebih baru, Anda harus menggunakan direktif AddProperty dan DelProperty untuk mengatur dan menghapus properti perangkat.

  • Untuk properti perangkat yang diperkenalkan pada Windows Server 2003, Windows XP, atau Windows 2000, dan yang dapat diatur oleh direktif AddReg dan dihapus oleh direktif DelReg , Anda harus terus menggunakan direktif AddReg dan DelReg untuk mengatur dan menghapus properti perangkat ini. Anda tidak boleh menggunakan direktif AddProperty dan DelProperty .

Anda dapat menyertakan direktif INF AddProperty dan arahan INF DelProperty di bagian file INF berikut untuk mengatur dan menghapus properti untuk instans perangkat, kelas penyiapan perangkat, kelas antarmuka perangkat, dan antarmuka perangkat:

Menggunakan Direktif AddProperty INF

Untuk memodifikasi nilai properti, sertakan direktif INF AddProperty di bagian yang menginstal instans perangkat, kelas penyiapan perangkat, kelas antarmuka perangkat, atau antarmuka perangkat. Direktif AddProperty mereferensikan satu atau beberapa add-property-section yang menyertakan entri yang menentukan properti, cara memodifikasi properti, dan nilai yang digunakan untuk memodifikasi properti. Format arahan AddProperty adalah sebagai berikut:

AddProperty=add-property-section[,add-property-section] ...

Setiap baris dalam bagian add-property menentukan satu properti. Berikut ini memperlihatkan dua kemungkinan format baris yang menentukan informasi properti. Format baris pertama yang ditampilkan menentukan properti berdasarkan namanya. Format ini hanya dapat digunakan dengan properti DEVPKEY_DrvPkg_Xxx . Format baris kedua menentukan properti menurut kategori properti dan pengidentifikasi properti dari kunci properti yang sesuai. Format kedua ini dapat digunakan untuk menentukan properti yang ditentukan sistem atau properti perangkat kustom.

[add-property-section]property-name,,,[flags],value{property-category-guid},property-pid,type,[flags],value Nilai entri menyediakan yang berikut:

property-name
Nama yang mengidentifikasi properti DEVPKEY_DrvPkg_Xxx . Misalnya, DeviceModel, yang mewakili properti DEVPKEY_DrvPkg_Model, atau DeviceVendorWebSite, yang mewakili properti DEVPKEY_DrvPkg_VendorWebSite.

property-category-guid
Nilai GUID dari kategori properti tempat properti berada. Misalnya, properti DEVPKEY_Device_FriendlyName yang ditentukan sistem. Nilai GUID juga dapat menentukan kategori perangkat kustom.

property-pid
Pengidentifikasi properti yang mengidentifikasi properti dalam kategori properti. Misalnya, nilai pengidentifikasi properti untuk properti DEVPKEY_Device_FriendlyName adalah 14.

Bendera
Bendera opsional yang menunjukkan cara mengubah nilai properti.

Jenis
Pengidentifikasi jenis data properti yang menentukan jenis data.

value
Nilai yang digunakan untuk mengubah nilai properti.

Contoh direktif AddProperty berikut menyertakan dua entri baris. Baris pertama menyertakan nilai entri nama properti "DeviceModel" dan nilai entri nilai "Contoh Nama Model Perangkat." Entri ini mengatur properti DEVPKEY_DrvPkg_Model. Entri baris kedua mengatur properti kustom dalam kategori properti kustom. Nilai entri property-category-guid adalah "c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e" dan nilai entri pengidentifikasi properti adalah "2." Nilai entri Bendera opsional tidak ada dan nilai entri jenis adalah "18" (DEVPROP_TYPE_STRING). Nilai entri nilai adalah "Nilai string untuk properti 1."

[Root_Install.NT]
AddProperty=Root_AddProperty

[Root_AddProperty]
DeviceModel,,,,"Sample Device Model Name"
{c22189e4-8bf3-4e6d-8467-8dc6d95e2a7e}, 2, 18,, "String value for property 1"

Menggunakan Direktif INF DelProperty

Untuk menghapus properti, sertakan direktif INF DelProperty di bagian yang menginstal instans perangkat, kelas penyiapan perangkat, kelas antarmuka perangkat, atau antarmuka perangkat.

Tujuan utama direktif INF DelProperty adalah untuk digunakan dalam file INF yang memperbarui penginstalan perangkat. Dalam kasus seperti itu, arahan DelProperty dapat digunakan untuk menghapus properti yang ditetapkan oleh penginstalan sebelumnya, tetapi tidak lagi diperlukan oleh penginstalan yang diperbarui. Gunakan arahan DelProperty dengan hati-hati. DelProperty tidak boleh digunakan untuk menghapus properti yang mungkin juga diatur oleh komponen sistem atau oleh file INF lain.

Direktif DelProperty memiliki format berikut:

DelProperty=del-property-section[,del-property-section] ...

Setiap baris dalam del-property-section menentukan satu properti. Berikut ini memperlihatkan dua kemungkinan format baris yang menentukan informasi properti. Format baris pertama yang ditampilkan menentukan properti berdasarkan namanya. Format ini hanya dapat digunakan dengan properti DEVPKEY_DrvPkg_Xxx . Format baris kedua menentukan properti menurut kategori properti dan pengidentifikasi properti dari kunci properti yang sesuai. Format kedua dapat digunakan untuk menentukan properti yang ditentukan sistem atau properti perangkat kustom.

[del-property-section]property-name [,, Flags [,value]] {property-category-guid}, property-pid [, Flags [,value]] Nilai entri menyediakan yang berikut:

property-name
Nama yang mengidentifikasi properti DEVPKEY_DrvPkg_Xxx . Misalnya, DeviceModel, yang mewakili properti DEVPKEY_DrvPkg_Model, atau DeviceVendorWebSite, yang mewakili properti DEVPKEY_Device_FriendlyName.

property-category-guid
Nilai GUID dari kategori properti tempat properti berada. Misalnya, properti DEVPKEY_Device_FriendlyName yang ditentukan sistem. Nilai GUID juga dapat menentukan kategori perangkat kustom.

property-pid
Pengidentifikasi properti yang mengidentifikasi properti dalam kategori properti. Misalnya, nilai pengidentifikasi properti untuk properti DEVPKEY_Device_FriendlyName adalah 14.

Bendera
Bendera opsional yang valid untuk digunakan hanya dengan properti yang jenis datanya DEVPROP_TYPE_STRING_LIST. Jika bendera diatur, operasi penghapusan akan menghapus string yang ditentukan oleh nilai dari daftar string properti.

value
String yang akan dihapus dari daftar string properti.

Contoh del-property-section berikut menyertakan dua entri baris.

Baris pertama menyertakan nilai entri nama properti "DeviceModel", yang menghapus properti DEVPKEY_DrvPkg_Model. 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"