DIF_PROPERTYCHANGE

Статья
06/15/2023

Запрос DIF_PROPERTYCHANGE уведомляет установщик о том, что свойства устройства изменяются. Устройство включается, отключается, запускается, останавливается или изменяется какой-либо элемент на странице свойств. Этот запрос DIF дает установщику возможность участвовать в изменении.

При отправке

При включении, отключении, перезапуске, остановке устройства или изменении его свойств.

Например, Windows отправляет этот запрос, когда поставщик страниц свойств устанавливает флаг DI_FLAGSEX_PROPCHANGE_PENDING в поле FlagsEx структуры SP_DEVINSTALL_PARAMS для устройства.

Дополнительные сведения об обнаружении первого запуска устройства или последующего перезапуска см. в разделе Операция установщика.

Кто обрабатывает

Со-установщик класса	Может обрабатывать
Совместный установщик устройств	Может обрабатывать
Установщик классов	Может обрабатывать

Входные данные установщика

DeviceInfoSet
Предоставляет дескриптор для набора сведений об устройстве , содержащего устройство.

DeviceInfoData
Предоставляет указатель на структуру SP_DEVINFO_DATA для устройства в наборе сведений об устройстве.

Параметры установки устройства
Существуют параметры установки устройства (SP_DEVINSTALL_PARAMS), связанные с DeviceInfoData.

Параметры установки класса
Структура SP_PROPCHANGE_PARAMS связана с DeviceInfoData.

Выходные данные установщика

Ни один

Возвращаемое значение установщика

Совместный установщик может возвращать NO_ERROR, ERROR_DI_POSTPROCESSING_REQUIRED или код ошибки Win32.

Если установщик класса успешно обрабатывает этот запрос и SetupDiCallClassInstaller должен впоследствии вызвать обработчик по умолчанию, установщик класса возвращает ERROR_DI_DO_DEFAULT.

Если установщик класса успешно обрабатывает этот запрос, включая прямой вызов обработчика по умолчанию, установщик класса должен вернуть NO_ERROR и SetupDiCallClassInstaller впоследствии не будет вызывать обработчик по умолчанию снова.

Примечание Установщик класса может напрямую вызывать обработчик по умолчанию, но установщик класса никогда не должен пытаться заменять операции обработчика по умолчанию.

Дополнительные сведения о вызове обработчика по умолчанию см. в разделе Вызов обработчиков кода DIF по умолчанию.

Если установщик класса обнаруживает ошибку, установщик должен вернуть соответствующий код ошибки Win32, и SetupDiCallClassInstaller впоследствии не будет вызывать обработчик по умолчанию.

Обработчик кода DIF по умолчанию

SetupDiChangeState

Операция установщика

В ответ на запрос DIF_PROPERTYCHANGE установщик может участвовать в операции изменения свойства. Параметры установки класса (SP_PROPCHANGE_PARAMS) указывают, какие изменения происходят.

Изменение свойства может потребовать перезагрузки системы. Сведения о перезапуске системы см. в разделе SetupDiCallClassInstaller.

Когда Windows отправляет DIF_INSTALLDEVICE запрос на установку устройства в первый раз, Windows запускает устройство, но не отправляет запрос DIF_PROPERTYCHANGE в процессе установки. Если пользовательская операция установки должна выполняться при первом запуске устройства и при последующем перезапуске устройства, установщик или совместный установщик должны обработать запрос DIF_INSTALLDEVICE, который запускает устройство в первый раз, и запрос DIF_PROPERTYCHANGE, указывающий, что действие изменения состояния заключается в том, что устройство запускается.

Дополнительные сведения о кодах DIF см. в разделе Обработка кодов DIF.

Требования

Версия	Поддерживается в Microsoft Windows 2000 и более поздних версиях Windows.
Заголовок	Setupapi.h (включая Setupapi.h)