Fungsi SetupDiInstallDeviceInterfaces (setupapi.h)

Artikel
03/04/2024

Fungsi SetupDiInstallDeviceInterfaces adalah handler default untuk permintaan penginstalan DIF_INSTALLINTERFACES .

Sintaks

WINSETUPAPI BOOL SetupDiInstallDeviceInterfaces(
  [in] HDEVINFO         DeviceInfoSet,
  [in] PSP_DEVINFO_DATA DeviceInfoData
);

Parameter

[in] DeviceInfoSet

Penunjuk ke kumpulan informasi perangkat yang berisi elemen informasi perangkat yang mewakili perangkat untuk menginstal antarmuka. Kumpulan informasi perangkat hanya boleh berisi elemen untuk sistem lokal.

[in] DeviceInfoData

Penunjuk ke struktur SP_DEVINFO_DATA yang menentukan elemen informasi perangkat di DeviceInfoSet.

Nilai kembali

SetupDiInstallDeviceInterfaces mengembalikan TRUE jika fungsi selesai tanpa kesalahan. Jika fungsi selesai dengan kesalahan, FALSE dikembalikan dan kode kesalahan untuk kegagalan dapat diambil dengan memanggil GetLastError.

Keterangan

SetupDiInstallDeviceInterfaces memproses setiap entri AddInterface di DDInstall. Bagian antarmuka dari file INF perangkat dan membuat setiap antarmuka dengan memanggil SetupDiCreateDeviceInterface.

Pemanggil SetupDiInstallDeviceInterfaces harus menjadi anggota grup Administrator.

Catatan Hanya penginstal kelas yang harus memanggil SetupDiInstallDeviceInterfaces dan hanya dalam situasi di mana penginstal kelas harus melakukan operasi penginstalan antarmuka perangkat setelah SetupDiInstallDeviceInterfaces menyelesaikan operasi penginstalan antarmuka perangkat default. Dalam situasi seperti itu, penginstal kelas harus langsung memanggil SetupDiInstallDeviceInterfaces ketika alat penginstal memproses permintaan DIF_INSTALLINTERFACES. Untuk informasi selengkapnya tentang memanggil handler default, lihat Memanggil Penangan Kode DIF Default.

Untuk informasi tentang format file INF, lihat Bagian dan Arahan File INF.

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
DLL	Setupapi.dll

Lihat juga

DIF_INSTALLINTERFACES

SetupDiCreateDeviceInterface

Bagikan melalui