SetupDiGetDriverInfoDetailA (setupapi.h)

  • Artikel

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.

CatatanDriverInfoDetailData.cbSize tidak boleh diatur ke nilai parameter DriverInfoDetailDataSize.
 

[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

Lihat juga

SetupDiEnumDriverInfo

SetupDiGetSelectedDriver