DIF_NEWDEVICEWIZARD_SELECT
Запрос DIF_NEWDEVICEWIZARD_SELECT позволяет установщику предоставлять настраиваемые страницы мастера, заменяющие стандартную страницу 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_SELECT позволяет установщику предоставлять настраиваемые страницы мастера, заменяющие стандартную страницу select-driver. Этот запрос используется только во время ручной установки устройств, отличных от PnP.
Установщик отвечает на этот запрос DIF, чтобы полностью заменить стандартную страницу мастера select-driver. Если вместо этого установщику нужно изменить только стандартную страницу или список драйверов, из которых следует выбрать, установщик должен сделать это в ответ на запрос DIF_SELECTDEVICE .
Совместный установщик должен добавлять пользовательские страницы в своем проходе постобработки и только в том случае, если установщик класса не добавил пользовательские страницы. Если установщик класса добавил страницы, совместный установщик не должен. В противном случае пользователю может быть предложено выбрать драйвер дважды.
Если установщик предоставляет настраиваемую страницу выбора, установщик должен задать выбранный драйвер. В коде установщика, поддерживающем страницу мастера, после нажатия кнопки Далее установщик должен вызвать SetupDiSetSelectedDriver.
Установщик должен предоставить заголовок мастера 97 и заголовок в структуре PROPSHEETPAGE для настраиваемой страницы мастера. Установщик не должен заменять заголовок мастера, предоставленный системой. Дополнительные сведения о страницах свойств см. в Microsoft Windows SDK документации по структуре PROPSHEETPAGE.
Дополнительные сведения о кодах DIF см. в разделе Обработка кодов DIF.
Требования
Версия |
Поддерживается в Microsoft Windows 2000 и более поздних версиях Windows. |
Заголовок |
Setupapi.h (включая Setupapi.h) |
См. также раздел
DIF_NEWDEVICEWIZARD_PREANALYZE