Fungsi SetupDiEnumDeviceInfo (setupapi.h)

  • Artikel

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)

Lihat juga

SP_DEVINFO_DATA

SetupDiCreateDeviceInfo

SetupDiDeleteDeviceInfo

SetupDiEnumDeviceInterfaces

SetupDiOpenDeviceInfo