Fungsi SetupDiGetDriverInstallParamsA (setupapi.h)

Artikel
03/01/2024

Fungsi SetupDiGetDriverInstallParams mengambil parameter penginstalan driver untuk kumpulan informasi perangkat atau elemen informasi perangkat tertentu.

Sintaks

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

Parameter

[in] DeviceInfoSet

Handel ke kumpulan informasi perangkat yang berisi elemen informasi driver yang mewakili driver untuk mengambil parameter penginstalan.

[in, optional] DeviceInfoData

Penunjuk ke struktur SP_DEVINFO_DATA yang berisi elemen informasi perangkat yang mewakili perangkat untuk mengambil parameter penginstalan. Parameter ini bersifat opsional dan dapat berupa NULL. Jika parameter ini ditentukan, SetupDiGetDriverInstallParams mengambil informasi tentang driver yang merupakan anggota daftar driver untuk perangkat yang ditentukan. Jika parameter ini adalah NULL, SetupDiGetDriverInstallParams mengambil informasi tentang driver yang merupakan anggota daftar driver kelas global untuk DeviceInfoSet.

[in] DriverInfoData

Penunjuk ke struktur SP_DRVINFO_DATA yang menentukan elemen informasi driver yang mewakili driver untuk mengambil parameter penginstalan. Jika DeviceInfoData disediakan, driver harus menjadi anggota daftar driver untuk perangkat yang ditentukan oleh DeviceInfoData. Jika tidak, driver harus menjadi anggota daftar driver kelas global untuk DeviceInfoSet.

[out] DriverInstallParams

Penunjuk ke struktur SP_DRVINSTALL_PARAMS untuk menerima parameter penginstalan untuk driver ini.

Mengembalikan nilai

Fungsi mengembalikan TRUE jika berhasil. Jika tidak, ia mengembalikan FALSE dan kesalahan yang dicatat dapat diambil oleh panggilan ke GetLastError.

Keterangan

Catatan

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

SetupDiSetDriverInstallParams

Bagikan melalui