Fungsi SetupDiSetSelectedDriverW (setupapi.h)
Set fungsi SetupDiSetSelectedDriver , atau reset, driver yang dipilih untuk elemen informasi perangkat atau driver kelas yang dipilih untuk kumpulan informasi perangkat.
Sintaks
WINSETUPAPI BOOL SetupDiSetSelectedDriverW(
[in] HDEVINFO DeviceInfoSet,
[in, out] PSP_DEVINFO_DATA DeviceInfoData,
[in, out] PSP_DRVINFO_DATA_W DriverInfoData
);
Parameter
[in] DeviceInfoSet
Handel ke set informasi perangkat yang berisi daftar driver tempat memilih driver untuk elemen informasi perangkat atau untuk set informasi perangkat.
[in, out] 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, SetupDiSetSelectedDriver mengatur, atau mengatur ulang, driver yang dipilih untuk perangkat yang ditentukan. Jika parameter ini NULL, SetupDiSetSelectedDriver mengatur, atau mengatur ulang, driver kelas yang dipilih untuk DeviceInfoSet.
[in, out] DriverInfoData
Penunjuk ke struktur SP_DRVINFO_DATA yang menentukan driver yang akan dipilih. Parameter ini bersifat opsional dan dapat berupa NULL. Jika parameter ini dan DeviceInfoData disediakan, driver yang ditentukan harus menjadi anggota daftar driver yang terkait dengan DeviceInfoData. Jika parameter ini ditentukan dan DeviceInfoData adalah NULL, driver harus menjadi anggota daftar driver kelas global untuk DeviceInfoSet. Jika parameter ini ADALAH NULL, driver yang dipilih diatur ulang untuk elemen informasi perangkat, jika DeviceInfoData ditentukan, atau informasi perangkat diatur, jika DeviceInfoData adalah NULL.
Jika DriverInfoData.Dicadangkan adalah NULL, pemanggil meminta pencarian simpul driver dengan parameter yang ditentukan (DriverType, Description, dan ProviderName). Jika kecocokan ditemukan, simpul driver tersebut dipilih. Bidang Khusus diperbarui pada output untuk mencerminkan simpul driver aktual tempat kecocokan ditemukan. Jika kecocokan tidak ditemukan, fungsi gagal dan panggilan ke GetLastError mengembalikan ERROR_INVALID_PARAMETER.
Mengembalikan nilai
Fungsi mengembalikan TRUE jika berhasil. Jika tidak, ia mengembalikan FALSE dan kesalahan yang dicatat dapat diambil dengan panggilan ke GetLastError.
Keterangan
Jika pemanggil SetupDiSetSelectedDriver adalah anggota grup Administrator, kelas perangkat diatur ke kelas driver yang dipilih, asalkan kedua kelas berbeda.
Jika DriverInfoData adalah NULL, SetupDiSetSelectedDriver mengatur ulang driver yang dipilih. Akibatnya, tidak ada driver yang dipilih.
Catatan
Header setupapi.h mendefinisikan SetupDiSetSelectedDriver sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur 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
| 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 |