SetupDiSetDeviceInstallParamsA (setupapi.h)

Fungsi SetupDiSetDeviceInstallParams mengatur parameter penginstalan perangkat untuk set informasi perangkat atau elemen informasi perangkat tertentu.

Sintaksis

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

Parameter

[in] DeviceInfoSet

Handel ke kumpulan informasi perangkat untuk mengatur parameter penginstalan perangkat.

[in, optional] DeviceInfoData

Penunjuk ke struktur SP_DEVINFO_DATA yang menentukan elemen informasi perangkat di DeviceInfoSet. Parameter ini bersifat opsional dan dapat diatur ke NULL. Jika parameter ini ditentukan, SetupDiSetDeviceInstallParams mengatur parameter penginstalan untuk perangkat yang ditentukan. Jika parameter ini NULL, SetupDiSetDeviceInstallParams mengatur parameter penginstalan yang terkait dengan daftar driver kelas global untuk DeviceInfoSet.

[in] DeviceInstallParams

Penunjuk ke struktur SP_DEVINSTALL_PARAMS yang berisi nilai baru parameter. DeviceInstallParams . cbSize harus diatur ke ukuran, dalam byte, dari struktur sebelum fungsi ini dipanggil.

Mengembalikan nilai

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

Komentar

Semua parameter divalidasi sebelum perubahan apa pun dibuat. Oleh karena itu, nilai pengembalian FALSE menunjukkan bahwa tidak ada parameter yang dimodifikasi.

Nota

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

SetupDiGetDeviceInstallParams