DIF_INSTALLINTERFACES

Статья
06/15/2023

Запрос DIF_INSTALLINTERFACES позволяет установщику участвовать в регистрации интерфейсов устройства.

При отправке

После регистрации совместного установщика устройств, но перед завершением установки устройства.

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

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

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

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

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

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

Параметры установки класса
Нет

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

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

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

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

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

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

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

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

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

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

SetupDiInstallDeviceInterfaces

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

В ответ на запрос DIF_INSTALLINTERFACES установщик может зарегистрировать интерфейс устройства программным способом, а не через INF-файл. Как правило, предоставляемые поставщиком установщики не обрабатывают этот запрос DIF.

Если не установлен флаг DI_NOFILECOPY, установщик, обрабатывающий этот запрос DIF, должен копировать файлы, необходимые для интерфейсов устройств.

Если флаг DI_NOFILECOPY не задан, но установлен флаг DI_NOVCP, установщик должен помещать все операции с файлами в очередь предоставленных файлов, но не должен фиксировать очередь.

Если установщик регистрирует интерфейс устройства, компонент режима ядра для устройства (например, драйвер) должен вызвать IoSetDeviceInterfaceState , чтобы включить интерфейс.

Если установщик возвращает код ошибки Win32, Windows останавливает установку.

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

Требования

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

См. также раздел