SetupDiGetClassInstallParamsA (setupapi.h)

Artikel
03/15/2023

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

Sintaks

WINSETUPAPI BOOL SetupDiGetClassInstallParamsA(
  [in]            HDEVINFO                DeviceInfoSet,
  [in, optional]  PSP_DEVINFO_DATA        DeviceInfoData,
  [out, optional] PSP_CLASSINSTALL_HEADER ClassInstallParams,
  [in]            DWORD                   ClassInstallParamsSize,
  [out, optional] PDWORD                  RequiredSize
);

Parameter

[in] DeviceInfoSet

Handel ke kumpulan informasi perangkat yang berisi parameter penginstalan kelas 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, SetupDiGetClassInstallParams mengambil parameter penginstalan kelas untuk perangkat yang ditentukan. Jika parameter ini NULL, SetupDiGetClassInstallParams mengambil parameter penginstalan kelas untuk daftar driver kelas global yang terkait dengan DeviceInfoSet.

[out, optional] ClassInstallParams

Penunjuk ke buffer yang berisi struktur SP_CLASSINSTALL_HEADER . Struktur ini harus memiliki anggota cbSize yang diatur ke sizeof(SP_CLASSINSTALL_HEADER) pada input atau buffer dianggap tidak valid. Pada output, anggota InstallFunction diisi dengan kode fungsi penginstalan perangkat untuk parameter penginstalan kelas yang diambil. Jika buffer cukup besar, buffer juga menerima struktur parameter penginstalan kelas khusus untuk kode fungsi. Jika ClassInstallParams tidak ditentukan, ClassInstallParamsSize harus 0.

[in] ClassInstallParamsSize

Ukurannya, dalam byte, dari buffer ClassInstallParams . Jika buffer disediakan, setidaknya harus sebesar sizeof(SP_CLASSINSTALL_HEADER). Jika buffer tidak disediakan, ClassInstallParamsSize harus 0.

[out, optional] RequiredSize

Pointer ke variabel jenis DWORD yang menerima jumlah byte yang diperlukan untuk menyimpan parameter penginstalan kelas. Parameter ini bersifat opsional dan dapat berupa NULL.

Nilai kembali

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

Keterangan

Parameter penginstalan kelas khusus untuk kode fungsi penginstalan perangkat tertentu yang disimpan di bidang ClassInstallHeader yang terletak di awal buffer ClassInstallParams .

Catatan

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

SetupDiSetClassInstallParams