Fungsi SetupDiInstallDriverFiles (setupapi.h)

Artikel
03/15/2023

Fungsi SetupDiInstallDriverFiles adalah handler default untuk permintaan penginstalan DIF_INSTALLDEVICEFILES .

Sintaks

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

Parameter

[in] DeviceInfoSet

Handel ke kumpulan informasi perangkat yang berisi elemen informasi perangkat yang mewakili perangkat untuk menginstal file. Kumpulan informasi perangkat tidak boleh berisi elemen jarak jauh.

[in] DeviceInfoData

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

Nilai kembali

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

Keterangan

Pemanggil SetupDiInstallDriverFiles harus menjadi anggota grup Administrator jika fungsi ini digunakan untuk menginstal file. Namun, jika fungsi ini digunakan untuk membangun antrean file, keanggotaan di grup Administrator tidak diperlukan.

Catatan Hanya penginstal kelas yang harus memanggil SetupDiInstallDriverFiles dan hanya dalam situasi di mana penginstal kelas harus melakukan operasi penginstalan file driver setelah SetupDiInstallDriverFiles menyelesaikan operasi penginstalan file driver default. Dalam situasi seperti itu, penginstal kelas harus langsung memanggil SetupDiInstallDriverFiles saat alat penginstal memproses permintaan DIF_INSTALLDEVICEFILES. Untuk informasi selengkapnya tentang memanggil handler default, lihat Memanggil Penangan Kode DIF Default.

Operasi SetupDiInstallDriverFiles mirip dengan fungsi SetupDiInstallDevice . Namun, fungsi ini hanya melakukan operasi penyalinan file yang dilakukan oleh SetupDiInstallDevice.

Pengandar harus dipilih untuk set informasi perangkat atau elemen yang ditentukan sebelum fungsi ini dipanggil.

Fungsi ini memproses entri CopyFiles, Delfiles, dan Renfiles dalam file INF yang dipilih.

DeviceInfoSet hanya boleh berisi elemen pada komputer lokal.

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

SetupDiCallClassInstaller

SetupDiInstallDevice

Bagikan melalui