Fungsi SetupDiSetClassInstallParamsA (setupapi.h)

Artikel
08/26/2023

Set fungsi SetupDiSetClassInstallParams atau menghapus parameter penginstalan kelas untuk set informasi perangkat atau elemen informasi perangkat tertentu.

Sintaks

WINSETUPAPI BOOL SetupDiSetClassInstallParamsA(
  [in]           HDEVINFO                DeviceInfoSet,
  [in, optional] PSP_DEVINFO_DATA        DeviceInfoData,
  [in, optional] PSP_CLASSINSTALL_HEADER ClassInstallParams,
  [in]           DWORD                   ClassInstallParamsSize
);

Parameter

[in] DeviceInfoSet

Handel ke informasi perangkat yang ditetapkan untuk mengatur parameter penginstalan kelas.

[in, optional] DeviceInfoData

Penunjuk ke struktur SP_DEVINFO_DATA yang mewakili perangkat untuk mengatur parameter penginstalan kelas. Parameter ini bersifat opsional dan dapat berupa NULL. Jika parameter ini ditentukan, SetupDiSetClassInstallParams mengatur parameter penginstalan kelas untuk perangkat yang ditentukan. Jika parameter ini NULL, SetupDiSetClassInstallParams mengatur parameter penginstalan kelas yang terkait dengan DeviceInfoSet.

[in, optional] ClassInstallParams

Penunjuk ke buffer yang berisi parameter penginstalan kelas baru untuk digunakan. Struktur SP_CLASSINSTALL_HEADER di awal buffer ini harus memiliki bidang cbSize yang diatur ke sizeof(SP_CLASSINSTALL_HEADER) dan bidang InstallFunction harus diatur ke kode DI_FUNCTION yang mencerminkan jenis parameter yang terkandung dalam buffer lainnya.

Jika ClassInstallParams tidak ditentukan, parameter penginstalan kelas saat ini, jika ada, dibersihkan untuk set atau elemen informasi perangkat yang ditentukan.

[in] ClassInstallParamsSize

Ukuran, dalam byte, dari buffer ClassInstallParams . Jika buffer tidak disediakan (yaitu, parameter penginstalan kelas sedang dibersihkan), ClassInstallParamsSize harus 0.

Nilai kembali

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

Keterangan

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

Efek samping dari pengaturan parameter penginstalan kelas adalah bahwa bendera DI_CLASSINSTALLPARAMS diatur. Jika penelepon ingin mengatur parameter, tetapi menonaktifkan penggunaannya, bendera ini harus dibersihkan dengan panggilan ke SetupDiSetDeviceInstallParams.

Jika parameter penginstalan kelas dibersihkan, bendera DI_CLASSINSTALLPARAMS diatur ulang.

Catatan

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


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

SetupDiGetClassInstallParams

SetupDiSetDeviceInstallParams

Bagikan melalui