DIF_UNREMOVE
Permintaan DIF_UNREMOVE memberi tahu alat penginstal bahwa Windows akan mengembalikan perangkat di profil perangkat keras tertentu dan memberi penginstal kesempatan untuk berpartisipasi dalam operasi. Windows hanya mengirim permintaan ini untuk perangkat non-PnP.
Ketika Dikirim
Ketika perangkat root-enumerated, perangkat non-PnP dipulangkan ke profil perangkat keras.
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
Struktur SP_UNREMOVEDEVICE_PARAMS dikaitkan dengan DeviceInfoData. Bidang Cakupan harus diatur ke DI_UNREMOVEDEVICE_CONFIGSPECIFIC dan profil perangkat keras harus ditentukan di bidang HwProfile .
Output Alat Penginstal
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
Operasi Alat Penginstal
"Membatalkan penghapusan" perangkat pada dasarnya berarti bahwa Windows menghapus bendera yang sebelumnya menandai perangkat sebagai "tidak ada" di profil perangkat keras tertentu.
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) |