Fungsi SetupDiSelectBestCompatDrv (setupapi.h)

Artikel
03/15/2023

Fungsi SetupDiSelectBestCompatDrv adalah handler default untuk permintaan penginstalan DIF_SELECTBESTCOMPATDRV .

Sintaks

WINSETUPAPI BOOL SetupDiSelectBestCompatDrv(
  [in]      HDEVINFO         DeviceInfoSet,
  [in, out] PSP_DEVINFO_DATA DeviceInfoData
);

Parameter

[in] DeviceInfoSet

Handel ke kumpulan informasi perangkat yang berisi elemen informasi perangkat yang mewakili perangkat untuk memilih driver yang paling kompatibel.

[in, out] DeviceInfoData

Penunjuk ke struktur SP_DEVINFO_DATA yang menentukan elemen informasi perangkat di DeviceInfoSet. SetupDiSelectBestCompatDrv memilih driver terbaik untuk elemen informasi perangkat dari daftar driver yang kompatibel untuk perangkat yang ditentukan.

Nilai kembali

Jika operasi berhasil, SetupDiSelectBestCompatDrv mengembalikan TRUE. Jika tidak, fungsi mengembalikan FALSE dan kesalahan yang dicatat dapat diambil oleh panggilan ke GetLastError.

Keterangan

Jika pemanggil SetupDiSelectBestCompatDrv adalah anggota grup Administrator dan kelas perangkat berbeda dengan kelas driver yang dipilih, SetupDiSelectBestCompatDrv mengatur kelas perangkat ke kelas driver. Jika perilaku ini tidak diinginkan, panggil fungsi ini pada tingkat hak istimewa yang lebih rendah.

Catatan Hanya penginstal kelas yang harus memanggil SetupDiSelectBestCompatDrv dan hanya dalam situasi di mana penginstal kelas harus melakukan operasi pemilihan driver setelah SetupDiSelectBestCompatDrv menyelesaikan operasi pemilihan driver default. Dalam situasi seperti itu, penginstal kelas harus langsung memanggil SetupDiSelectBestCompatDrv ketika alat penginstal memproses permintaan DIF_SELECTBESTCOMPATDRV. Untuk informasi selengkapnya tentang memanggil handler default, lihat Memanggil Penangan Kode DIF Default.

SetupDiSelectBestCompatDrv terutama dirancang untuk memilih driver yang paling kompatibel untuk elemen informasi perangkat di komputer lokal. Meskipun SetupDiSelectBestCompatDrv tidak akan gagal jika set informasi perangkat adalah untuk komputer jarak jauh, hasilnya adalah penggunaan terbatas karena kumpulan informasi perangkat kemudian tidak dapat digunakan sebagai input dengan permintaan penginstalan DIF_Xxx atau fungsi SetupDiXxx yang tidak mendukung operasi untuk komputer jarak jauh. Secara khusus, set informasi perangkat kemudian tidak dapat digunakan sebagai input dengan permintaan penginstalan DIF_INSTALLDEVICE untuk menginstal perangkat di komputer jarak jauh.

Untuk informasi tentang bagaimana driver terbaik dipilih, lihat Cara Windows Memilih Driver.

Untuk mendapatkan driver yang dipilih untuk perangkat, panggil SetupDiGetSelectedDriver.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows 2000 dan versi Windows yang lebih baru.
Target Platform	Desktop
Header	setupapi.h (termasuk Setupapi.h)
Pustaka	Setupapi.lib
DLL	Setupapi.dll

Lihat juga

DIF_SELECTBESTCOMPATDRV

SP_DEVINFO_DATA

Bagikan melalui