Fungsi SetupDiGetClassInstallParamsW (setupapi.h)

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

Sintaksis

WINSETUPAPI BOOL SetupDiGetClassInstallParamsW(
  [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 set informasi perangkat yang diatur 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 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 mengatur anggota cbSize 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 ukuran (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 NULL.

Mengembalikan nilai

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

Komentar

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

Nota

Header setupapi.h menentukan SetupDiGetClassInstallParams 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

SetupDiSetClassInstallParams