DIF_PROPERTYCHANGE
Permintaan DIF_PROPERTYCHANGE memberi tahu alat penginstal bahwa properti perangkat berubah. Perangkat sedang diaktifkan, dinonaktifkan, dimulai, dihentikan, atau beberapa item pada halaman properti telah berubah. Permintaan DIF ini memberi alat penginstal kesempatan untuk berpartisipasi dalam perubahan.
Ketika Dikirim
Saat perangkat diaktifkan, dinonaktifkan, dimulai ulang, dihentikan, atau propertinya telah berubah.
Misalnya, Windows mengirim permintaan ini ketika penyedia halaman properti mengatur bendera DI_FLAGSEX_PROPCHANGE_PENDING di bidang FlagsEx dari struktur SP_DEVINSTALL_PARAMS untuk perangkat.
Untuk informasi selengkapnya tentang mendeteksi kapan perangkat dimulai untuk pertama kalinya atau kemudian dimulai ulang, lihat bagian Operasi Penginstal.
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 untuk perangkat dalam set informasi perangkat.
Parameter Penginstalan Perangkat
Ada parameter penginstalan perangkat (SP_DEVINSTALL_PARAMS) yang terkait dengan DeviceInfoData.
Parameter Penginstalan Kelas
Struktur SP_PROPCHANGE_PARAMS dikaitkan dengan DeviceInfoData.
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
Menanggapi permintaan DIF_PROPERTYCHANGE alat penginstal dapat berpartisipasi dalam operasi perubahan properti. Parameter penginstalan kelas (SP_PROPCHANGE_PARAMS) menunjukkan perubahan mana yang terjadi.
Perubahan properti mungkin memerlukan hidupkan ulang sistem. Untuk informasi tentang cara memulai ulang sistem, lihat SetupDiCallClassInstaller.
Ketika Windows mengirim permintaan DIF_INSTALLDEVICE untuk menginstal perangkat untuk pertama kalinya, Windows memulai perangkat tetapi tidak mengirim permintaan DIF_PROPERTYCHANGE sebagai bagian dari penginstalan. Jika operasi penginstalan kustom harus dilakukan saat perangkat dimulai untuk pertama kalinya dan setiap kali perangkat dimulai ulang, penginstal atau penginstal bersama harus menangani permintaan DIF_INSTALLDEVICE yang memulai perangkat untuk pertama kalinya dan permintaan DIF_PROPERTYCHANGE yang menunjukkan bahwa tindakan perubahan status adalah bahwa perangkat sedang dimulai.
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) |