DIF_UNREMOVE
Запрос DIF_UNREMOVE уведомляет установщик о том, что Windows восстанавливает устройство в заданном профиле оборудования, и дает установщику возможность участвовать в операции. Windows отправляет этот запрос только для устройств, отличных от PnP.
При отправке
Когда устройство с корнем, отличное от PnP, восстанавливается в профиле оборудования.
Кто обрабатывает
Со-установщик класса |
Может обрабатывать |
Совместный установщик устройств |
Может обрабатывать |
Установщик классов |
Может обрабатывать |
Входные данные установщика
DeviceInfoSet
Предоставляет дескриптор для набора сведений об устройстве , содержащего устройство.
DeviceInfoData
Предоставляет указатель на структуру SP_DEVINFO_DATA , которая идентифицирует устройство в наборе сведений об устройстве.
Параметры установки устройства
Существуют параметры установки устройства (SP_DEVINSTALL_PARAMS), связанные с DeviceInfoData.
Параметры установки класса
Структура SP_UNREMOVEDEVICE_PARAMS связана с DeviceInfoData. Для поля Область должно быть задано значение DI_UNREMOVEDEVICE_CONFIGSPECIFIC, а в поле HwProfile должен быть указан профиль оборудования.
Выходные данные установщика
Возвращаемое значение установщика
Совместный установщик может возвращать NO_ERROR, ERROR_DI_POSTPROCESSING_REQUIRED или код ошибки Win32.
Если установщик класса успешно обрабатывает этот запрос и SetupDiCallClassInstaller должен впоследствии вызвать обработчик по умолчанию, установщик класса возвращает ERROR_DI_DO_DEFAULT.
Если установщик класса успешно обрабатывает этот запрос, включая прямой вызов обработчика по умолчанию, установщик класса должен вернуть NO_ERROR и SetupDiCallClassInstaller впоследствии не будет вызывать обработчик по умолчанию снова.
Примечание Установщик класса может напрямую вызывать обработчик по умолчанию, но установщик класса никогда не должен пытаться заменять операции обработчика по умолчанию.
Дополнительные сведения о вызове обработчика по умолчанию см. в разделе Вызов обработчиков кода DIF по умолчанию.
Если установщик класса обнаруживает ошибку, установщик должен вернуть соответствующий код ошибки Win32, и SetupDiCallClassInstaller впоследствии не будет вызывать обработчик по умолчанию.
Обработчик кода DIF по умолчанию
Операция установщика
"Удаление" устройства в основном означает, что Windows снимает флаг, который ранее помечает устройство как "не присутствует" в определенном профиле оборудования.
Дополнительные сведения о кодах DIF см. в разделе Обработка кодов DIF.
Требования
Версия |
Поддерживается в Microsoft Windows 2000 и более поздних версиях Windows. |
Заголовок |
Setupapi.h (включая Setupapi.h) |