Fungsi SetupDiEnumDeviceInfo (setupapi.h)

Fungsi SetupDiEnumDeviceInfo mengembalikan struktur SP_DEVINFO_DATA yang menentukan elemen informasi perangkat dalam kumpulan informasi perangkat.

Syntax

WINSETUPAPI BOOL SetupDiEnumDeviceInfo(
  [in]  HDEVINFO         DeviceInfoSet,
  [in]  DWORD            MemberIndex,
  [out] PSP_DEVINFO_DATA DeviceInfoData
);

Parameter-parameternya

[in] DeviceInfoSet

Handel ke informasi perangkat yang ditetapkan 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).

Mengembalikan nilai

Fungsi mengembalikan TRUE jika berhasil. Jika tidak, kesalahan mengembalikan FALSE dan kesalahan yang dicatat dapat diambil dengan panggilan ke GetLastError.

Komentar

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 set informasi perangkat.

Untuk menghitung elemen informasi perangkat, alat penginstal awalnya harus memanggil SetupDiEnumDeviceInfo dengan parameter MemberIndex yang 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).

Contoh penggunaan SetupDiEnumDeviceInfo tersedia di halaman yang mendokumentasikan SetupDiGetClassDevsW.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Microsoft Windows 2000 dan versi Windows yang lebih baru.
Platform Target	Dekstop
Header	setupapi.h (termasuk Setupapi.h)
Library	Setupapi.lib
DLL	Setupapi.dll
Set API	ext-ms-win-setupapi-classinstallers-l1-1-0 (diperkenalkan di Windows 8)

Lihat juga

SP_DEVINFO_DATA

SetupDiCreateDeviceInfo

SetupDiDeleteDeviceInfo

SetupDiEnumDeviceInterfaces

SetupDiOpenDeviceInfo