DIF_INSTALLINTERFACES
Permintaan DIF_INSTALLINTERFACES memungkinkan alat penginstal untuk berpartisipasi dalam pendaftaran antarmuka perangkat untuk perangkat.
Ketika Dikirim
Setelah mendaftarkan penginstal bersama perangkat tetapi sebelum menyelesaikan penginstalan perangkat.
Siapa yang Menangani
Penginstal Bersama Kelas |
Dapat menangani |
Penginstal Bersama Perangkat |
Dapat menangani |
Penginstal Kelas |
Dapat menangani |
Input Alat Penginstal
DeviceInfoSet
Menyediakan handel ke set informasi perangkat yang berisi perangkat.
DeviceInfoData
Menyediakan 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.
Parameter Penginstalan Kelas
Tidak ada
Output Alat Penginstal
Parameter Penginstalan Perangkat
Alat penginstal mungkin mengubah parameter penginstalan perangkat, tetapi biasanya tidak untuk permintaan DIF ini.
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 kemudian tidak akan memanggil handler default.
Handler Kode DIF Default
SetupDiInstallDeviceInterfaces
Operasi Alat Penginstal
Menanggapi permintaan DIF_INSTALLINTERFACES alat penginstal mungkin mendaftarkan antarmuka perangkat secara terprogram alih-alih memiliki antarmuka yang terdaftar melalui file INF. Biasanya, alat penginstal yang disediakan vendor tidak menangani permintaan DIF ini.
Kecuali bendera DI_NOFILECOPY diatur, alat penginstal yang menangani permintaan DIF ini harus menyalin file yang diperlukan untuk antarmuka perangkat.
Jika bendera DI_NOFILECOPY jelas tetapi bendera DI_NOVCP diatur, alat penginstal harus mengantrekan operasi file apa pun ke antrean file yang disediakan tetapi tidak boleh melakukan antrean.
Jika alat penginstal mendaftarkan antarmuka perangkat, komponen mode kernel untuk perangkat (misalnya, driver) harus memanggil IoSetDeviceInterfaceState untuk mengaktifkan antarmuka.
Jika alat penginstal mengembalikan kode kesalahan Win32, Windows akan menghentikan penginstalan.
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) |