SetupDiGetDeviceInstallParamsA (setupapi.h)

Artikel
03/04/2024

Fungsi SetupDiGetDeviceInstallParams mengambil parameter penginstalan perangkat untuk set informasi perangkat atau elemen informasi perangkat tertentu.

Sintaks

WINSETUPAPI BOOL SetupDiGetDeviceInstallParamsA(
  [in]           HDEVINFO                DeviceInfoSet,
  [in, optional] PSP_DEVINFO_DATA        DeviceInfoData,
  [out]          PSP_DEVINSTALL_PARAMS_A DeviceInstallParams
);

Parameter

[in] DeviceInfoSet

Handel ke kumpulan informasi perangkat yang berisi parameter penginstalan perangkat untuk diambil.

[in, optional] 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, SetupDiGetDeviceInstallParams mengambil parameter penginstalan untuk perangkat yang ditentukan. Jika parameter ini NULL, fungsi mengambil parameter penginstalan perangkat global yang terkait dengan DeviceInfoSet.

[out] DeviceInstallParams

Penunjuk ke struktur SP_DEVINSTALL_PARAMS yang menerima parameter penginstalan perangkat. DeviceInstallParams. cbSize harus diatur ke ukuran, dalam byte, dari struktur sebelum memanggil fungsi ini.

Mengembalikan nilai

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

Keterangan

Catatan

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

SP_DEVINFO_DATA

SP_DEVINSTALL_PARAMS

SetupDiSetDeviceInstallParams

Share via