SetupDiGetSelectedDriverA (setupapi.h)

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

Sintaksis

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

Parameter

[in] DeviceInfoSet

Handel ke set informasi perangkat yang diatur untuk mengambil driver yang dipilih.

[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 NULL. Jika parameter ini ditentukan, SetupDiGetSelectedDriver mengambil driver yang dipilih untuk perangkat yang ditentukan. Jika parameter ini null, SetupDiGetSelectedDriver mengambil driver kelas yang dipilih dalam daftar driver kelas global yang terkait dengan DeviceInfoSet.

[out] DriverInfoData

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

Mengembalikan nilai

Fungsi mengembalikan TRUE jika berhasil. Jika tidak, ini 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.

Komentar

Nota

Header setupapi.h mendefinisikan SetupDiGetSelectedDriver 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

SetupDiSetSelectedDriver