Fungsi SetupDiEnumDriverInfoW (setupapi.h)

Fungsi SetupDiEnumDriverInfo menghitung anggota daftar driver.

Sintaksis

WINSETUPAPI BOOL SetupDiEnumDriverInfoW(
  [in]           HDEVINFO           DeviceInfoSet,
  [in, optional] PSP_DEVINFO_DATA   DeviceInfoData,
  [in]           DWORD              DriverType,
  [in]           DWORD              MemberIndex,
  [out]          PSP_DRVINFO_DATA_W DriverInfoData
);

Parameter

[in] DeviceInfoSet

Handel ke set informasi perangkat yang diatur yang berisi daftar driver untuk dijumlahkan.

[in, optional] DeviceInfoData

Penunjuk ke struktur SP_DEVINFO_DATA yang menentukan elemen informasi perangkat di DeviceInfoSet. Parameter ini bersifat opsional dan dapat NULL. Jika parameter ini ditentukan, SetupDiEnumDriverInfo menghitung daftar driver untuk perangkat yang ditentukan. Jika parameter ini NULL, SetupDiEnumDriverInfo menghitung daftar driver kelas global yang terkait dengan DeviceInfoSet (daftar ini berjenis SPDIT_CLASSDRIVER).

[in] DriverType

Jenis daftar driver yang akan dijumlahkan, yang harus menjadi salah satu nilai berikut:

SPDIT_CLASSDRIVER

Menghitung daftar driver kelas. Tipe daftar driver ini harus ditentukan jika DeviceInfoData tidak ditentukan.

SPDIT_COMPATDRIVER

Menghitung daftar driver yang kompatibel untuk perangkat yang ditentukan. Tipe daftar driver ini hanya dapat ditentukan jika DeviceInfoData juga ditentukan.

[in] MemberIndex

Indeks berbasis nol dari anggota informasi driver yang akan diambil.

[out] DriverInfoData

Penunjuk ke struktur SP_DRVINFO_DATA yang diinisialisasi pemanggil yang menerima informasi tentang driver yang dijumlahkan. Pemanggil harus mengatur DriverInfoData.cbSize untuk sizeof(SP_DRVINFO_DATA) sebelum memanggil SetupDiEnumDriverInfo. Jika anggota cbSize tidak diatur dengan benar, SetupDiEnumDriverInfo akan mengembalikan FALSE.

Mengembalikan nilai

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

Komentar

Untuk menghitung anggota set informasi driver, penginstal harus terlebih dahulu memanggil SetupDiEnumDriverInfo dengan parameter MemberIndex diatur ke 0. Kemudian harus menaikkan MemberIndex dan memanggil SetupDiEnumDriverInfo sampai tidak ada nilai lagi. Ketika tidak ada nilai lagi, fungsi gagal dan panggilan ke GetLastError mengembalikan ERROR_NO_MORE_ITEMS.

Jika Anda tidak menginisialisasi cbSize anggota struktur SP_DRVINFO_DATA yang disediakan oleh pointer DriverInfoData, fungsi akan gagal dan mencatat kesalahan ERROR_INVALID_USER_BUFFER.

Untuk membuat daftar driver yang terkait dengan perangkat tertentu atau dengan daftar driver kelas global untuk set informasi perangkat, pertama-tama gunakan SetupDiBuildDriverInfoList lalu teruskan daftar tersebut ke SetupDiEnumDriverInfo.

Nota

Header setupapi.h mendefinisikan SetupDiEnumDriverInfo sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Tersedia di Microsoft Windows 2000 dan versi Windows yang lebih baru.
Platform Target	Desktop
Header	setupapi.h (termasuk Setupapi.h)
Pustaka	Setupapi.lib

Lihat juga

SetupDiBuildDriverInfoList