Fungsi SetupDiSetClassInstallParamsA (setupapi.h)

Artikel
2024-11-20

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

Sintaksis

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 kumpulan informasi perangkat 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 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 di sisa buffer.

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

[in] ClassInstallParamsSize

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

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.

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

Jika parameter penginstalan kelas dibersihkan, bendera DI_CLASSINSTALLPARAMS diatur ulang.

Nota

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

SetupDiGetClassInstallParams

SetupDiSetDeviceInstallParams

Bagikan melalui