SetupDiGetDriverInfoDetailA (setupapi.h)
Fungsi SetupDiGetDriverInfoDetail mengambil detail informasi driver untuk kumpulan informasi perangkat atau elemen informasi perangkat tertentu dalam kumpulan informasi perangkat.
Sintaks
WINSETUPAPI BOOL SetupDiGetDriverInfoDetailA(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[in] PSP_DRVINFO_DATA_A DriverInfoData,
[in, out] PSP_DRVINFO_DETAIL_DATA_A DriverInfoDetailData,
[in] DWORD DriverInfoDetailDataSize,
[out, optional] PDWORD RequiredSize
);
Parameter
[in] DeviceInfoSet
Handel ke set informasi perangkat yang berisi elemen informasi driver untuk mengambil informasi driver.
[in, optional] DeviceInfoData
Penunjuk ke struktur SP_DEVINFO_DATA yang menentukan elemen informasi perangkat yang mewakili perangkat untuk mengambil informasi driver. Parameter ini bersifat opsional dan dapat berupa NULL. Jika parameter ini ditentukan, SetupDiGetDriverInfoDetail mengambil informasi tentang driver dalam daftar driver untuk perangkat yang ditentukan. Jika parameter ini NULL, SetupDiGetDriverInfoDetail mengambil informasi tentang driver yang merupakan anggota daftar driver kelas global untuk DeviceInfoSet.
[in] DriverInfoData
Penunjuk ke struktur SP_DRVINFO_DATA yang menentukan elemen informasi driver yang mewakili driver untuk mengambil detailnya. Jika DeviceInfoData ditentukan, driver harus menjadi anggota daftar driver untuk perangkat yang ditentukan oleh DeviceInfoData. Jika tidak, driver harus menjadi anggota daftar driver kelas global untuk DeviceInfoSet.
[in, out] DriverInfoDetailData
Penunjuk ke struktur SP_DRVINFO_DETAIL_DATA yang menerima informasi terperinci tentang driver yang ditentukan. Jika parameter ini tidak ditentukan, DriverInfoDetailDataSize harus nol. Jika parameter ini ditentukan, DriverInfoDetailData.cbSize harus diatur ke nilai sizeof(SP_DRVINFO_DETAIL_DATA) sebelum memanggil SetupDiGetDriverInfoDetail.
[in] DriverInfoDetailDataSize
Ukuran, dalam byte, dari buffer DriverInfoDetailData .
[out, optional] RequiredSize
Penunjuk ke variabel yang menerima jumlah byte yang diperlukan untuk menyimpan informasi driver terperinci. Nilai ini mencakup ukuran struktur dan byte tambahan yang diperlukan untuk buffer karakter panjang variabel di akhir yang menyimpan daftar ID perangkat keras dan daftar ID yang kompatibel. Daftar dalam format REG_MULTI_SZ. Untuk informasi tentang perangkat keras dan ID yang kompatibel, lihat String Identifikasi Perangkat.
Nilai kembali
Fungsi mengembalikan TRUE jika berhasil. Jika tidak, kesalahan mengembalikan FALSE dan kesalahan yang dicatat dapat diambil dengan melakukan panggilan ke GetLastError.
Keterangan
Jika anggota informasi driver yang ditentukan dan buffer yang disediakan pemanggil keduanya valid, fungsi ini dijamin untuk mengisi semua bidang statis dalam struktur SP_DRVINFO_DETAIL_DATA dan ID sebanyak mungkin dalam buffer panjang variabel di akhir sambil tetap mempertahankan format REG_MULTI_SZ. Dalam hal ini, fungsi mengembalikan FALSE dan panggilan ke GetLastError mengembalikan ERROR_INSUFFICIENT_BUFFER. Jika ditentukan, RequiredSize berisi jumlah total byte yang diperlukan untuk struktur dengan semua ID.
Catatan
Header setupapi.h mendefinisikan SetupDiGetDriverInfoDetail 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
| 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 |