Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Properti perangkat DEVPKEY_DrvPkg_Icon mewakili daftar ikon perangkat yang digunakan Windows untuk mewakili instans perangkat secara visual.
| Atribut | Nilai |
|---|---|
| Kunci properti | DEVPKEY_DrvPkg_Icon |
| Pengidentifikasi tipe data properti | DEVPROP_TYPE_STRING_LIST |
| Akses properti | Akses baca-saja oleh aplikasi penginstalan dan alat penginstal |
| Lokal | Ya |
Keterangan
Setiap ikon dalam daftar ditentukan oleh jalur file ikon (*.ico) atau referensi ke sumber daya ikon dalam file yang dapat dieksekusi.
Ikon pertama dalam daftar digunakan sebagai default. Ikon tambahan dapat disediakan yang menyediakan representasi visual perangkat yang berbeda. Windows menyertakan antarmuka pengguna yang memungkinkan pengguna memilih ikon mana yang ditampilkan Windows. Misalnya, Microsoft DiscoveryCam 530 tersedia dalam warna biru, hijau, dan merah. Microsoft menyediakan ikon untuk setiap warna. Windows menggunakan ikon biru secara default karena merupakan ikon pertama dalam daftar. Namun, pengguna Windows juga dapat memilih ikon hijau atau ikon merah.
Daftar ikon adalah daftar penentu ikon yang dipisahkan NULL. Penentu ikon adalah jalur file ikon (*.ico) atau penentu sumber daya ikon, sebagai berikut:
Format jalur ke file ikon adalah DirectoryPath\filename.ico.
Penentu sumber daya ikon memiliki entri berikut:
@executable-file-path,resource-identifierKarakter pertama penentu sumber daya ikon adalah tanda (@) diikuti dengan jalur file yang dapat dieksekusi (file *.exe atau *.dll ), diikuti oleh pemisah koma (,), lalu entri pengidentifikasi sumber daya .
Misalnya, penentu ikon"@shell32.dll,-30" mewakili file yang dapat dieksekusi "shell32.dll" dan pengidentifikasi sumber daya "-30".
Pengidentifikasi sumber daya harus berupa nilai bilangan bulat, yang sesuai dengan sumber daya dalam file yang dapat dieksekusi, sebagai berikut:
Jika pengidentifikasi yang disediakan negatif, Windows menggunakan sumber daya dalam file yang dapat dieksekusi yang pengidentifikasinya sama dengan nilai absolut dari pengidentifikasi yang disediakan.
Jika pengidentifikasi yang disediakan adalah nol, Windows menggunakan sumber daya dalam file yang dapat dieksekusi yang pengidentifikasinya memiliki nilai terendah dalam file yang dapat dieksekusi.
Jika pengidentifikasi yang disediakan positif, misalnya, nilai n, Windows menggunakan sumber daya dalam file yang dapat dieksekusi yang pengidentifikasinya adalah nilai terendah n+1 dalam file yang dapat dieksekusi. Misalnya, jika nilai n adalah 1, Windows menggunakan sumber daya yang pengidentifikasinya memiliki nilai terendah kedua dalam file yang dapat dieksekusi.
Anda dapat mengatur nilai DEVPKEY_DrvPkg_Icon oleh direktif ADDProperty INF yang disertakan di bagian INF DDInstall dari file INF yang menginstal perangkat. Anda dapat mengambil nilai DEVPKEY_DrvPkg_Icon dengan memanggil CM_Get_DevNode_Property atau SetupDiGetDeviceProperty.
Berikut ini adalah contoh cara menggunakan direktif INF AddProperty untuk mengatur DEVPKEY_DrvPkg_Icon untuk perangkat yang diinstal oleh bagian INF DDInstall "SampleDDInstallSection":
[SampleDDinstallSection]
...
AddProperty=SampleAddPropertySection
...
[SampleAddPropertySection]
DeviceIcon,,,,"SomeResource.dll,-2","SomeIcon.icon"
...
Persyaratan
Versi: Windows Vista dan versi Windows yang lebih baru
Header: Devpkey.h (sertakan Devpkey.h)