DIF_INSTALLDEVICEFILES
Permintaan DIF_INSTALLDEVICEFILES memungkinkan alat penginstal untuk berpartisipasi dalam menyalin file untuk mendukung perangkat atau membuat daftar file untuk perangkat. File perangkat mencakup file untuk driver yang dipilih, antarmuka perangkat apa pun, dan penginstal bersama apa pun.
Ketika Dikirim
Komponen penginstalan perangkat yang disediakan sistem mengirimkan permintaan DIF ini karena berbagai alasan. Beberapa komponen penginstalan perangkat mengirim permintaan DIF ini sebelum DIF_REGISTER_COINSTALLERS, DIF_INSTALLINTERFACES, dan DIF_INSTALL_DEVICE untuk memastikan bahwa semua file yang relevan dapat disalin sebelum melanjutkan penginstalan. Beberapa komponen penginstalan perangkat menghilangkan permintaan DIF ini dan mengharapkan file disalin selama penanganan ketiga permintaan DIF tersebut. Selain itu, beberapa komponen penginstalan perangkat mengirim permintaan DIF ini untuk mengambil daftar file yang terkait dengan perangkat.
Siapa yang Menangani
Penginstal Bersama Kelas |
Dapat menangani |
Penginstal Bersama Perangkat |
Tidak menangani |
Penginstal Kelas |
Dapat menangani |
Input Alat Penginstal
DeviceInfoSet
Menyediakan handel ke set informasi perangkat yang berisi perangkat yang file pendukungnya akan disalin.
DeviceInfoData
Memasok pointer ke struktur SP_DEVINFO_DATA yang mengidentifikasi perangkat dalam set informasi perangkat.
Parameter Penginstalan Perangkat
Ada parameter penginstalan perangkat (SP_DEVINSTALL_PARAMS) yang terkait dengan DeviceInfoData.
Jika bendera DI_NOVCP diatur, parameter penginstalan perangkat berisi handel dan alat penginstal FileQueue yang valid yang menangani permintaan DIF ini menambahkan operasi file mereka ke antrean ini dan tidak menerapkan antrean.
Parameter Penginstalan Kelas
Tidak ada
Output Alat Penginstal
Parameter Penginstalan Perangkat
Alat penginstal dapat mengubah FileQueue, jika ada.
Nilai Pengembalian Alat Penginstal
Penginstal bersama dapat mengembalikan kode kesalahan NO_ERROR, ERROR_DI_POSTPROCESSING_REQUIRED, atau Win32.
Jika penginstal kelas berhasil menangani permintaan ini dan SetupDiCallClassInstaller kemudian harus memanggil handler default, penginstal kelas mengembalikan ERROR_DI_DO_DEFAULT.
Jika penginstal kelas berhasil menangani permintaan ini, termasuk langsung memanggil handler default, penginstal kelas harus mengembalikan NO_ERROR dan SetupDiCallClassInstaller kemudian tidak akan memanggil handler default lagi.
Catatan Penginstal kelas dapat langsung memanggil handler default, tetapi penginstal kelas tidak boleh mencoba menggantikan operasi handler default.
Untuk informasi selengkapnya tentang memanggil handler default, lihat Memanggil Penangan Kode DIF Default.
Jika penginstal kelas mengalami kesalahan, penginstal harus mengembalikan kode kesalahan Win32 yang sesuai dan SetupDiCallClassInstaller tidak akan kemudian memanggil handler default.
Handler Kode DIF Default
Operasi Alat Penginstal
Menanggapi permintaan DIF_INSTALLDEVICEFILES alat penginstal menentukan operasi file yang diperlukan. Misalnya, alat penginstal dapat menentukan file tambahan yang akan disalin yang diperlukan untuk penginstalan perangkat. Jika bendera DI_NOVCP diatur, alat penginstal menentukan operasi file dengan menambahkannya ke FileQueue di parameter penginstalan perangkat. Lihat Microsoft Windows SDK untuk informasi tentang cara menggunakan antrean file dan untuk halaman referensi pada fungsi antrean file seperti SetupInstallFilesFromInfSection.
Jika permintaan DIF ini dikirim selama penginstalan perangkat, dan alat penginstal mengembalikan kode kesalahan Microsoft Win32, Windows akan menghentikan penginstalan.
Jika komponen penginstalan perangkat yang disediakan sistem mengirimkan permintaan DIF ini untuk mengambil daftar file yang terkait dengan perangkat, komponen mengambil antrean file tetapi tidak melakukan antrean.
Untuk informasi selengkapnya tentang kode DIF, lihat Menangani Kode DIF.
Persyaratan
Versi |
Didukung di Microsoft Windows 2000 dan versi Windows yang lebih baru. |
Header |
Setupapi.h (termasuk Setupapi.h) |