Fungsi SetupDiGetSelectedDriverW (setupapi.h)

Fungsi SetupDiGetSelectedDriver mengambil driver yang dipilih untuk kumpulan informasi perangkat atau elemen informasi perangkat tertentu.

Sintaks

WINSETUPAPI BOOL SetupDiGetSelectedDriverW(
  [in]           HDEVINFO           DeviceInfoSet,
  [in, optional] PSP_DEVINFO_DATA   DeviceInfoData,
  [out]          PSP_DRVINFO_DATA_W DriverInfoData
);

Parameter

[in] DeviceInfoSet

Handel ke set informasi perangkat untuk mengambil driver terpilih.

[in, optional] DeviceInfoData

Penunjuk ke struktur SP_DEVINFO_DATA yang menentukan elemen informasi perangkat yang mewakili perangkat di DeviceInfoSet untuk mengambil driver yang dipilih. Parameter ini bersifat opsional dan dapat berupa NULL. Jika parameter ini ditentukan, SetupDiGetSelectedDriver mengambil driver yang dipilih untuk perangkat yang ditentukan. Jika parameter ini NULL, SetupDiGetSelectedDriver mengambil driver kelas yang dipilih di daftar driver kelas global yang terkait dengan DeviceInfoSet.

[out] DriverInfoData

Penunjuk ke struktur SP_DRVINFO_DATA yang menerima informasi tentang driver yang dipilih.

Nilai kembali

Fungsi mengembalikan TRUE jika berhasil. Jika tidak, kesalahan mengembalikan FALSE dan kesalahan yang dicatat dapat diambil dengan panggilan ke GetLastError. Jika driver belum dipilih untuk instans perangkat yang ditentukan, kesalahan yang dicatat ERROR_NO_DRIVER_SELECTED.

Keterangan

Catatan

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

SetupDiSetSelectedDriver