Fungsi SetupDiLoadDeviceIcon (setupapi.h)

  • Artikel

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

Lihat juga

DEVPROP_TYPE_STRING_LIST

SetupDiLoadClassIcon