Fungsi SetupDiEnumDriverInfoA (setupapi.h)

Artikel
03/15/2023

Fungsi SetupDiEnumDriverInfo menghitung anggota daftar driver.

Sintaks

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

Parameter

[in] DeviceInfoSet

Handel ke set informasi perangkat 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 berupa 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 pengandar 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 penelepon yang menerima informasi tentang driver yang dijumlahkan. Pemanggil harus mengatur DriverInfoData.cbSize ke sizeof(SP_DRVINFO_DATA) sebelum memanggil SetupDiEnumDriverInfo. Jika anggota cbSize tidak diatur dengan benar, SetupDiEnumDriverInfo akan mengembalikan FALSE.

Nilai kembali

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

Keterangan

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 anggota cbSize dari struktur SP_DRVINFO_DATA yang disediakan oleh DriverInfoData penunjuk, 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.

Catatan

Header setupapi.h mendefinisikan SetupDiEnumDriverInfo sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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


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

Lihat juga

SetupDiBuildDriverInfoList

Bagikan melalui