Fungsi SetupDiSelectDevice (setupapi.h)

Artikel
03/15/2023

Fungsi SetupDiSelectDevice adalah handler default untuk permintaan DIF_SELECTDEVICE .

Sintaks

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

Parameter

[in] DeviceInfoSet

Handel ke set informasi perangkat yang berisi elemen informasi perangkat yang mewakili perangkat untuk memilih driver.

[in, out] DeviceInfoData

Penunjuk ke struktur SP_DEVINFO_DATA yang menentukan elemen informasi perangkat. Parameter ini bersifat opsional dan dapat berupa NULL. Jika parameter ini ditentukan, SetupDiSelectDevice memilih driver untuk perangkat yang ditentukan dan mengatur DeviceInfoData.ClassGuid ke GUID kelas penyiapan perangkat untuk driver yang dipilih. Jika parameter ini NULL, SetupDiSelectDevice mengatur driver yang dipilih dalam daftar driver kelas global untuk DeviceInfoSet.

Nilai kembali

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

Keterangan

SetupDiSelectDevice menangani antarmuka pengguna yang memungkinkan pengguna memilih driver untuk perangkat yang ditentukan, atau informasi perangkat yang ditetapkan jika perangkat tidak ditentukan. Dengan mengatur bidang Bendera dari struktur SP_DEVINSTALL_PARAMS untuk perangkat, atau informasi perangkat yang diatur jika perangkat tidak ditentukan, pemanggil dapat menentukan penanganan khusus antarmuka pengguna, misalnya, untuk memungkinkan pengguna memilih driver dari disk penginstalan OEM.

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

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

Persyaratan

Persyaratan	Nilai
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
DLL	Setupapi.dll

Lihat juga

SP_DEVINSTALL_PARAMS

SetupDiCallClassInstaller

Bagikan melalui