DIF_REGISTERDEVICE
Permintaan DIF_REGISTERDEVICE memungkinkan alat penginstal untuk berpartisipasi dalam mendaftarkan instans perangkat yang baru dibuat dengan manajer PnP. Windows mengirimkan permintaan DIF ini untuk perangkat non-PnP.
Ketika Dikirim
Saat alat penginstal melaporkan perangkat yang sebelumnya tidak diketahui sebagai respons terhadap permintaan DIF_DETECT . Windows mengirimkan permintaan DIF ini dalam fase analisis Wisaya Tambah Perangkat Keras sebelum menginstal perangkat. Windows juga mengirimkan permintaan ini selama deteksi non-PnP.
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.
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.
Parameter Penginstalan Kelas
Tidak ada
Output Alat Penginstal
Tidak ada
Nilai Pengembalian Alat Penginstal
Penginstal bersama dapat mengembalikan NO_ERROR atau kode kesalahan Win32. Penginstal bersama tidak boleh mengembalikan ERROR_DI_POSTPROCESSING_REQUIRED untuk permintaan DIF ini.
Jika alat penginstal menentukan bahwa perangkat adalah duplikat, perangkat akan mengembalikan ERROR_DUPLICATE_FOUND.
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.
Jika alat penginstal menentukan bahwa perangkat adalah duplikat, alat penginstal mengembalikan ERROR_DUPLICATE_FOUND.
Handler Kode DIF Default
Operasi Alat Penginstal
Aplikasi penginstalan perangkat biasanya mengirim permintaan DIF ini untuk mendaftarkan perangkat non-PnP dengan manajer PnP. Dimulai dengan Microsoft Windows 2000, perangkat non-PnP harus didaftarkan sebelum dapat diinstal.
Alat penginstal biasanya menangani permintaan DIF ini untuk melakukan deteksi duplikat. Alat penginstal seperti itu biasanya memanggil handler default (SetupDiRegisterDeviceInfo) dan menentukan rutinitas deteksinya. Jika pendaftaran berhasil dan alat penginstal menentukan bahwa perangkat bukan duplikat, alat penginstal mengembalikan NO_ERROR.
Penginstal bersama harus melakukan operasi apa pun untuk menangani permintaan DIF ini dalam pass pra-pemrosesannya. Ketika penginstal bersama dipanggil untuk pascaproscessing, instans perangkat telah didaftarkan oleh penginstal kelas atau handler default.
Jika alat penginstal mengembalikan kesalahan untuk kode DIF ini, biasanya ERROR_DUPLICATE_FOUND, Windows akan menghapus perangkat dari kumpulan informasi perangkat.
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) |