Fungsi SetupDiEnumDeviceInterfaces (setupapi.h)
Fungsi SetupDiEnumDeviceInterfaces menghitung antarmuka perangkat yang terkandung dalam kumpulan informasi perangkat.
Sintaks
WINSETUPAPI BOOL SetupDiEnumDeviceInterfaces(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[in] const GUID *InterfaceClassGuid,
[in] DWORD MemberIndex,
[out] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData
);
Parameter
[in] DeviceInfoSet
Penunjuk ke kumpulan informasi perangkat yang berisi antarmuka perangkat yang akan mengembalikan informasi. Handel ini biasanya dikembalikan oleh SetupDiGetClassDevs.
[in, optional] DeviceInfoData
Penunjuk ke struktur SP_DEVINFO_DATA yang menentukan elemen informasi perangkat di DeviceInfoSet. Parameter ini bersifat opsional dan dapat berupa NULL. Jika parameter ini ditentukan, SetupDiEnumDeviceInterfaces membatasi enumerasi ke antarmuka yang didukung oleh perangkat yang ditentukan. Jika parameter ini NULL, panggilan berulang ke SetupDiEnumDeviceInterfaces mengembalikan informasi tentang antarmuka yang terkait dengan semua elemen informasi perangkat di DeviceInfoSet. Pointer ini biasanya dikembalikan oleh SetupDiEnumDeviceInfo.
[in] InterfaceClassGuid
Pointer ke GUID yang menentukan kelas antarmuka perangkat untuk antarmuka yang diminta.
[in] MemberIndex
Indeks berbasis nol ke dalam daftar antarmuka dalam kumpulan informasi perangkat. Pemanggil harus memanggil fungsi ini terlebih dahulu dengan MemberIndex diatur ke nol untuk mendapatkan antarmuka pertama. Kemudian, berulang kali menaikkan MemberIndex dan mengambil antarmuka hingga fungsi ini gagal dan GetLastError mengembalikan ERROR_NO_MORE_ITEMS.
Jika DeviceInfoData menentukan perangkat tertentu, MemberIndex relatif hanya terhadap antarmuka yang diekspos oleh perangkat tersebut.
[out] DeviceInterfaceData
Penunjuk ke buffer yang dialokasikan pemanggil yang berisi, saat pengembalian berhasil, struktur SP_DEVICE_INTERFACE_DATA selesai yang mengidentifikasi antarmuka yang memenuhi parameter pencarian. Pemanggil harus mengatur DeviceInterfaceData. cbSize ke sizeof(SP_DEVICE_INTERFACE_DATA) sebelum memanggil fungsi ini.
Nilai kembali
SetupDiEnumDeviceInterfaces mengembalikan TRUE jika fungsi selesai tanpa kesalahan. Jika fungsi selesai dengan kesalahan, FALSE dikembalikan dan kode kesalahan untuk kegagalan dapat diambil dengan memanggil GetLastError.
Keterangan
Panggilan berulang ke fungsi ini mengembalikan struktur SP_DEVICE_INTERFACE_DATA untuk antarmuka perangkat yang berbeda. Fungsi ini dapat dipanggil berulang kali untuk mendapatkan informasi tentang antarmuka dalam kumpulan informasi perangkat yang terkait dengan elemen informasi perangkat tertentu atau yang terkait dengan semua elemen informasi perangkat.
DeviceInterfaceData menunjuk ke struktur yang mengidentifikasi antarmuka perangkat yang diminta. Untuk mendapatkan informasi terperinci tentang antarmuka, panggil SetupDiGetDeviceInterfaceDetail. Informasi terperinci mencakup nama antarmuka perangkat yang dapat diteruskan ke fungsi Win32 seperti CreateFile (dijelaskan dalam dokumentasi Microsoft Windows SDK) untuk mendapatkan handel ke antarmuka.
Lihat Gambaran Umum Kelas Antarmuka Perangkat untuk informasi selengkapnya.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| 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-2 (diperkenalkan dalam Windows 10, versi 10.0.14393) |