DIF_NEWDEVICEWIZARD_SELECT

Artikel
06/15/2023

Permintaan DIF_NEWDEVICEWIZARD_SELECT memungkinkan alat penginstal untuk menyediakan halaman wizard kustom yang menggantikan halaman pilih driver standar. Permintaan ini hanya digunakan selama penginstalan manual perangkat non-PnP.

Ketika Dikirim

Segera sebelum Windows menampilkan halaman "Pilih Driver 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.

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
Struktur SP_NEWDEVICEWIZARD_DATA dikaitkan dengan DeviceInfoData.

Output Alat Penginstal

Parameter Penginstalan Perangkat
Alat penginstal dapat memodifikasi bendera dalam parameter penginstalan perangkat. Windows tidak memeriksa bendera setelah permintaan DIF ini selesai. Namun, ini memeriksanya nanti dalam proses penginstalan.

Parameter Penginstalan Kelas
Alat penginstal dapat memodifikasi SP_NEWDEVICEWIZARD_DATA untuk menyediakan halaman kustom.

Nilai Pengembalian Alat Penginstal

Jika penginstal bersama tidak menangani permintaan DIF ini, ia akan mengembalikan NO_ERROR dari pass pra-pemrosesannya. Jika penginstal bersama menangani permintaan ini, ia dapat mengembalikan kode kesalahan NO_ERROR, ERROR_DI_POSTPROCESSING_REQUIRED, atau Win32.

Alat penginstal kelas mengembalikan NO_ERROR jika berhasil memasok halaman. Jika tidak, penginstal kelas mengembalikan kode kesalahan ERROR_DI_DO_DEFAULT atau Win32.

Handler Kode DIF Default

Tidak ada

Operasi Alat Penginstal

Alat penginstal merespons permintaan DIF ini untuk sepenuhnya mengganti halaman wizard select-driver standar. Jika, sebagai gantinya, alat penginstal hanya harus memodifikasi halaman standar atau memodifikasi daftar driver untuk dipilih, alat penginstal harus melakukannya sebagai respons terhadap permintaan DIF_SELECTDEVICE .

Penginstal bersama harus menambahkan halaman kustom dalam pass pascaproscessing dan hanya jika penginstal kelas tidak menambahkan halaman kustom. Jika penginstal kelas menambahkan halaman, penginstal bersama tidak boleh. Jika tidak, pengguna mungkin diminta untuk memilih driver dua kali.

Jika alat penginstal menyediakan halaman pilih kustom, penginstal harus mengatur driver yang dipilih. Dalam kode alat penginstal yang mendukung halaman wizard, setelah pengguna mengklik Berikutnya, alat penginstal harus memanggil SetupDiSetSelectedDriver.

Alat penginstal harus menyediakan judul header Wizard 97 dan subtitel header di struktur PROPSHEETPAGE untuk halaman wizard kustom. Alat penginstal tidak boleh mengganti judul wizard yang disediakan sistem. Lihat Microsoft Windows SDK untuk dokumentasi struktur PROPSHEETPAGE dan untuk informasi selengkapnya tentang halaman properti.

Untuk informasi selengkapnya tentang kode DIF, lihat Menangani Kode DIF.