DIF_NEWDEVICEWIZARD_PREANALYZE
Запрос DIF_NEWDEVICEWIZARD_PREANALYZE позволяет установщику предоставлять страницы мастера, отображаемые Windows пользователю перед отображением страницы анализа. Этот запрос используется только во время ручной установки устройств, отличных от PnP.
При отправке
После выбора пользователем драйвера, но до того, как Windows регистрирует устройство, которое делает узел устройства (devnode) "активным".
Кто обрабатывает
Со-установщик класса |
Может обрабатывать |
Совместный установщик устройств |
Не обрабатывает |
Установщик классов |
Может обрабатывать |
Входные данные установщика
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_PREANALYZE позволяет установщику предоставлять страницы мастера, отображаемые Windows пользователю перед отображением страницы анализа. Эти страницы можно рассматривать как страницы "postelect". Этот запрос используется только во время ручной установки устройств, отличных от PnP.
Установщик может использовать настраиваемую страницу предварительного анализ, например, для выбора COM-порта после выбора модемного устройства.
Если установщик добавляет настраиваемые страницы предварительного выбора, установщик должен сначала проверка, достиг ли NumDynamicPages в параметрах установки класса MAX_INSTALLWIZARD_DYNAPAGES.
Установщик должен предоставить заголовок мастера 97 и заголовок в структуре PROPSHEETPAGE для настраиваемой страницы мастера. Установщик не должен заменять заголовок мастера, предоставленный системой. Дополнительные сведения о страницах свойств см. в Microsoft Windows SDK документации по структуре PROPSHEETPAGE.
Дополнительные сведения о кодах DIF см. в разделе Обработка кодов DIF.
Требования
Версия |
Поддерживается в Microsoft Windows 2000 и более поздних версиях Windows. |
Заголовок |
Setupapi.h (включая Setupapi.h) |