struktur SP_CLASSINSTALL_HEADER (setupapi.h)
SP_CLASSINSTALL_HEADER adalah anggota pertama dari struktur parameter penginstalan kelas apa pun. Ini berisi kode permintaan penginstalan perangkat yang menentukan format struktur parameter penginstalan lainnya.
Sintaks
typedef struct _SP_CLASSINSTALL_HEADER {
DWORD cbSize;
DI_FUNCTION InstallFunction;
} SP_CLASSINSTALL_HEADER, *PSP_CLASSINSTALL_HEADER;
Anggota
cbSize
Ukuran, dalam byte, dari struktur SP_CLASSINSTALL_HEADER.
InstallFunction
Permintaan penginstalan perangkat (kode DIF) untuk struktur parameter penginstalan kelas.
Kode DIF memiliki format DIF_XXX dan didefinisikan dalam Setupapi.h. Lihat Kode Fungsi Penginstalan Perangkat untuk deskripsi lengkap kode DIF.
Keterangan
Saat komponen mengalokasikan struktur parameter penginstalan kelas, komponen biasanya menginisialisasi bidang header struktur. Komponen tersebut menetapkan anggota InstallFunction ke kode DIF untuk permintaan penginstalan dan mengatur cbSize ke ukuran struktur SP_CLASSINSTALL_HEADER. Contohnya:
SP_REMOVEDEVICE_PARAMS RemoveDeviceParams;
RemoveDeviceParams.ClassInstallHeader.cbSize = sizeof(SP_CLASSINSTALL_HEADER);
RemoveDeviceParams.ClassInstallHeader.InstallFunction = DIF_REMOVE;
Komponen harus mengatur anggota InstallFunction sebelum meneruskan struktur parameter penginstalan kelas ke SetupDiSetClassInstallParams.
Namun, komponen tidak harus mengatur bidang ini saat meneruskan parameter penginstalan kelas ke SetupDiGetClassInstallParams. Fungsi ini mengatur anggota InstallFunction dalam struktur yang diteruskannya kembali ke pemanggil. Ini mengatur InstallFunction ke kode DIF_XXX untuk permintaan penginstalan perangkat yang saat ini aktif.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header | setupapi.h (termasuk Setupapi.h) |