Fungsi SetupDiEnumDeviceInterfaces (setupapi.h)

  • Artikel

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)

Lihat juga

SetupDiEnumDeviceInfo

SetupDiGetClassDevs

SetupDiGetDeviceInterfaceDetail