Fungsi SetupDiSetSelectedDriverA (setupapi.h)

Artikel
03/13/2024

Set fungsi SetupDiSetSelectedDriver , atau reset, driver yang dipilih untuk elemen informasi perangkat atau driver kelas yang dipilih untuk kumpulan informasi perangkat.

Sintaks

WINSETUPAPI BOOL SetupDiSetSelectedDriverA(
  [in]      HDEVINFO           DeviceInfoSet,
  [in, out] PSP_DEVINFO_DATA   DeviceInfoData,
  [in, out] PSP_DRVINFO_DATA_A 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.

Nilai kembali

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

Lihat juga

SetupDiGetSelectedDriver

Bagikan melalui