DIF_NEWDEVICEWIZARD_PRESELECT
Запрос DIF_NEWDEVICEWIZARD_PRESELECT позволяет установщику предоставлять страницы мастера, отображаемые Windows пользователю перед отображением страницы select-driver. Этот запрос используется только во время ручной установки устройств, не относящихся к PnP.
При отправке
После того как пользователь выбрал класс для устройства, но перед Windows отобразится страница "Выбор драйвера устройства".
Кто обрабатывает
Совместный установщик класса |
Может обрабатывать |
Совместный установщик устройств |
Не обрабатывает |
Установщик классов |
Может обрабатывать |
Входные данные установщика
DeviceInfoSet
Предоставляет дескриптор набору сведений об устройстве , который содержит устройство.
DeviceInfoData
Предоставляет указатель на структуру SP_DEVINFO_DATA , которая идентифицирует устройство в наборе сведений об устройстве.
Параметры установки устройства
Существуют параметры установки устройства (SP_DEVINSTALL_PARAMS), связанные с DeviceInfoData.
Параметры установки класса
Структура SP_NEWDEVICEWIZARD_DATA связана с DeviceInfoData.
Выходные данные установщика
Параметры установки устройства
Установщик может изменять флаги в параметрах установки устройства. Windows не проверка флаги по завершении этого запроса DIF. Однако он проверяет их позже в процессе установки.
Параметры установки класса
Установщик может изменить SP_NEWDEVICEWIZARD_DATA для предоставления пользовательских страниц.
Возвращаемое значение установщика
Если совместный установщик не обрабатывает этот запрос DIF, он возвращает NO_ERROR из этапа предварительной обработки. Если совместный установщик обрабатывает этот запрос, он может вернуть NO_ERROR, ERROR_DI_POSTPROCESSING_REQUIRED или код ошибки Win32.
Установщик класса возвращает NO_ERROR, если он успешно предоставляет страницы. В противном случае установщик класса возвращает ERROR_DI_DO_DEFAULT или код ошибки Win32.
Обработчик кода DIF по умолчанию
Нет
Операция установщика
Запрос DIF_NEWDEVICEWIZARD_PRESELECT позволяет установщику предоставлять страницы мастера, отображаемые Windows пользователю перед отображением страницы select-driver. Этот запрос используется только во время ручной установки устройств, не относящихся к PnP.
Если установщик добавляет настраиваемые страницы предварительного выбора, установщик должен сначала проверка, достиг ли NumDynamicPages в параметрах установки класса MAX_INSTALLWIZARD_DYNAPAGES.
Совместный установщик может добавлять пользовательские страницы в проход предварительной обработки и (или) в проходе постобработки. Если он добавляет страницы в своем проходе предварительной обработки, эти страницы отображаются перед любыми страницами, предоставленными установщиком класса.
Если один или несколько установщиков добавляют настраиваемые страницы предварительного выбора, Windows отображает страницы перед страницей "Выбор драйвера устройства". Однако если пользователь нажимает "Назад" на странице select-driver, Windows пропускает настраиваемые страницы предварительного выбора и возвращается на страницу выбора класса "Тип оборудования".
Установщик должен предоставить заголовок Мастера 97 и заголовок заголовка в структуре PROPSHEETPAGE для настраиваемой страницы мастера. Установщик не должен заменять заголовок мастера, предоставленный системой. Документацию по структуре PROPSHEETPAGE и дополнительные сведения о страницах свойств см. в Microsoft Windows SDK.
Дополнительные сведения о кодах DIF см. в разделе Обработка кодов DIF.
Требования
Версия |
Поддерживается в Microsoft Windows 2000 и более поздних версиях Windows. |
Заголовок |
Setupapi.h (включая Setupapi.h) |
См. также раздел
DIF_NEWDEVICEWIZARD_PREANALYZE