Fungsi SetupDiCreateDeviceInfoList (setupapi.h)
Fungsi SetupDiCreateDeviceInfoList membuat kumpulan informasi perangkat kosong dan secara opsional mengaitkan set dengan kelas penyiapan perangkat dan jendela tingkat atas.
Sintaks
WINSETUPAPI HDEVINFO SetupDiCreateDeviceInfoList(
[in, optional] const GUID *ClassGuid,
[in, optional] HWND hwndParent
);
Parameter
[in, optional] ClassGuid
Penunjuk ke GUID kelas penyiapan perangkat untuk dikaitkan dengan kumpulan informasi perangkat yang baru dibuat. Jika parameter ini ditentukan, hanya perangkat kelas ini yang dapat disertakan dalam kumpulan informasi perangkat ini. Jika parameter ini diatur ke NULL, kumpulan informasi perangkat tidak terkait dengan kelas penyiapan perangkat tertentu.
[in, optional] hwndParent
Handel ke jendela tingkat atas yang akan digunakan untuk antarmuka pengguna apa pun yang terkait dengan tindakan non-perangkat tertentu (seperti kotak dialog pilih perangkat yang menggunakan daftar driver kelas global). Handel ini bersifat opsional dan dapat berupa NULL. Jika jendela tingkat atas tertentu tidak diperlukan, atur hwndParent ke NULL.
Menampilkan nilai
Fungsi mengembalikan handel ke set informasi perangkat kosong jika berhasil. Jika tidak, ia mengembalikan INVALID_HANDLE_VALUE. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Pemanggil fungsi ini harus menghapus informasi perangkat yang dikembalikan yang ditetapkan ketika tidak lagi diperlukan dengan memanggil SetupDiDestroyDeviceInfoList.
Untuk membuat daftar informasi perangkat untuk komputer jarak jauh, gunakan SetupDiCreateDeviceInfoListEx.
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-1 (diperkenalkan di Windows 8.1) |