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.

Sintaksis

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 diatur yang berisi daftar driver untuk 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 NULL. Jika parameter ini ditentukan, SetupDiSetSelectedDriver set, atau reset, driver yang dipilih untuk perangkat yang ditentukan. Jika parameter ini null, Set SetupDiSetSelectedDriver, atau reset, 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 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 NULL, driver harus menjadi anggota daftar driver kelas global untuk DeviceInfoSet. Jika parameter ini null, driver yang dipilih diatur ulang untuk elemen informasi perangkat, jika DeviceInfoData ditentukan, atau set informasi perangkat, jika DeviceInfoDataNULL.

Jika DriverInfoData.ReservedNULL, pemanggil meminta pencarian node driver dengan parameter yang ditentukan (DriverType, Deskripsi, dan ProviderName). Jika kecocokan ditemukan, simpul driver tersebut dipilih. Bidang yang dicadangkan diperbarui pada output untuk mencerminkan node 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, ini mengembalikan FALSE dan kesalahan yang dicatat dapat diambil dengan panggilan ke GetLastError.

Komentar

Jika pemanggil SetupDiSetSelectedDriver adalah anggota grup Administrator, kelas perangkat diatur ke kelas driver yang dipilih, asalkan dua kelas berbeda.

Jika DriverInfoData NULL, SetupDiSetSelectedDriver mengatur ulang driver yang dipilih. Akibatnya, tidak ada driver yang dipilih.

Nota

Header setupapi.h mendefinisikan SetupDiSetSelectedDriver sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosedur 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

Syarat	Nilai
klien minimum yang didukung	Tersedia di Microsoft Windows 2000 dan versi Windows yang lebih baru.
Platform Target	Desktop
Header	setupapi.h (termasuk Setupapi.h)
Pustaka	Setupapi.lib

Lihat juga

SetupDiGetSelectedDriver