Fungsi SetupDiEnumDeviceInfo (setupapi.h)
Fungsi SetupDiEnumDeviceInfo mengembalikan struktur SP_DEVINFO_DATA yang menentukan elemen informasi perangkat dalam kumpulan informasi perangkat.
Sintaks
WINSETUPAPI BOOL SetupDiEnumDeviceInfo(
[in] HDEVINFO DeviceInfoSet,
[in] DWORD MemberIndex,
[out] PSP_DEVINFO_DATA DeviceInfoData
);
Parameter
[in] DeviceInfoSet
Handel ke kumpulan informasi perangkat untuk mengembalikan struktur SP_DEVINFO_DATA yang mewakili elemen informasi perangkat.
[in] MemberIndex
Indeks berbasis nol dari elemen informasi perangkat untuk diambil.
[out] DeviceInfoData
Penunjuk ke struktur SP_DEVINFO_DATA untuk menerima informasi tentang elemen informasi perangkat yang dijumlahkan. Pemanggil harus mengatur DeviceInfoData. cbSize ke sizeof(SP_DEVINFO_DATA).
Menampilkan nilai
Fungsi mengembalikan TRUE jika berhasil. Jika tidak, ia mengembalikan FALSE dan kesalahan yang dicatat dapat diambil dengan panggilan ke GetLastError.
Keterangan
Panggilan berulang ke fungsi ini mengembalikan elemen informasi perangkat untuk perangkat lain. Fungsi ini dapat dipanggil berulang kali untuk mendapatkan informasi tentang semua perangkat dalam kumpulan informasi perangkat.
Untuk menghitung elemen informasi perangkat, alat penginstal awalnya harus memanggil SetupDiEnumDeviceInfo dengan parameter MemberIndex diatur ke 0. Alat penginstal kemudian harus menambahkan MemberIndex dan memanggil SetupDiEnumDeviceInfo sampai tidak ada nilai lagi (fungsi gagal dan panggilan ke GetLastError mengembalikan ERROR_NO_MORE_ITEMS).
Panggil SetupDiEnumDeviceInterfaces untuk mendapatkan struktur konteks untuk elemen antarmuka perangkat (versus elemen informasi perangkat).
Persyaratan
| Klien minimum yang didukung | Tersedia di Microsoft Windows 2000 dan versi Windows yang lebih baru. |
| Target Platform | Desktop |
| Header | setupapi.h (termasuk Setupapi.h) |
| Pustaka | Setupapi.lib |
| DLL | Setupapi.dll |
| Set API | ext-ms-win-setupapi-classinstallers-l1-1-0 (diperkenalkan di Windows 8) |