Fungsi SetupDiLoadDeviceIcon (setupapi.h)
Fungsi SetupDiLoadDeviceIcon mengambil ikon untuk perangkat tertentu.
Sintaks
WINSETUPAPI BOOL SetupDiLoadDeviceIcon(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVINFO_DATA DeviceInfoData,
[in] UINT cxIcon,
[in] UINT cyIcon,
[in] DWORD Flags,
[out] HICON *hIcon
);
Parameter
[in] DeviceInfoSet
Handel ke kumpulan informasi perangkat yang berisi elemen informasi perangkat yang mewakili perangkat untuk mengambil ikon.
[in] DeviceInfoData
Penunjuk ke struktur SP_DEVINFO_DATA yang menentukan elemen informasi perangkat di DeviceInfoSet.
[in] cxIcon
Lebar, dalam piksel, ikon yang akan diambil. Gunakan indeks metrik sistem SM_CXICON untuk menentukan ikon berukuran default atau gunakan indeks metrik sistem SM_CXSMICON untuk menentukan ikon kecil. Indeks metrik sistem didefinisikan dalam Winuser.h, dan nilai terkaitnya dapat diambil dengan panggilan ke fungsi GetSystemMetrics . (Fungsi GetSystemMetrics didokumenkan dalam Microsoft Windows SDK.)
[in] cyIcon
Tinggi, dalam piksel, ikon yang akan diambil. Gunakan SM_CXICON untuk menentukan ikon berukuran default atau gunakan SM_CXSMICON untuk menentukan ikon kecil.
[in] Flags
Tidak digunakan. Harus diatur ke nol.
[out] hIcon
Penunjuk ke handel ke ikon yang menerima handel ke ikon yang diambil fungsi ini. Setelah aplikasi yang memanggil fungsi ini selesai menggunakan ikon , aplikasi harus memanggil DestroyIcon untuk menghapus ikon. (DestroyIcon didokumenkan dalam Microsoft Windows SDK.)
Mengembalikan nilai
SetupDiLoadDeviceIcon mengembalikan TRUE jika fungsi berhasil mengambil ikon untuk perangkat yang ditentukan. Jika tidak, fungsi mengembalikan FALSE dan kesalahan yang dicatat dapat diambil oleh panggilan ke GetLastError.
Keterangan
SetupDiLoadDeviceIcon mencoba mengambil ikon untuk perangkat sebagai berikut:
-
Jika properti perangkat DEVPKEY_DrvPkg_Icon perangkat menyertakan daftar string pengidentifikasi sumber daya, fungsi mencoba mengambil ikon yang ditentukan oleh string pengidentifikasi sumber daya pertama dalam daftar.
Jenis data properti perangkat dari properti perangkat DEVPKEY_DrvPkg_Icon DEVPROP_TYPE_STRING_LIST.
Format string pengidentifikasi sumber daya adalah
[filepath\]filename,-resourceID
Di mana:
- filepath, diikuti oleh karakter garis miring terbalik (\\), bersifat opsional dan menentukan jalur file yang berisi ikon.
- FileName, diikuti oleh karakter koma (",") menentukan nama file yang berisi ikon.
- ResourceID, didahului oleh karakter tanda hubung ("-"), menentukan ID sumber daya ikon.
- Jika fungsi tidak dapat mengambil ikon khusus perangkat, fungsi tersebut kemudian akan mencoba mengambil ikon kelas untuk perangkat. Untuk informasi tentang ikon kelas, lihat SetupDiLoadClassIcon.
- Jika fungsi tidak dapat mengambil ikon kelas untuk perangkat, fungsi tersebut kemudian akan mencoba mengambil ikon untuk kelas Penyiapan perangkat yang tidak diketahui, di mana ikon untuk kelas Penyiapan perangkat yang tidak diketahui menyertakan gambar tanda tanya (?).
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Tersedia di Windows Vista dan versi Windows yang lebih baru. |
Target Platform | Desktop |
Header | setupapi.h (termasuk Setupapi.h) |
Pustaka | Setupapi.lib |
DLL | Setupapi.dll |