Функция SetupDiInstallDeviceInterfaces (setupapi.h)

Функция SetupDiInstallDeviceInterfaces является обработчиком по умолчанию для запроса на установку DIF_INSTALLINTERFACES.

Синтаксис

WINSETUPAPI BOOL SetupDiInstallDeviceInterfaces(
  [in] HDEVINFO         DeviceInfoSet,
  [in] PSP_DEVINFO_DATA DeviceInfoData
);

Параметры

[in] DeviceInfoSet

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

[in] DeviceInfoData

Указатель на структуру SP_DEVINFO_DATA , указывающую элемент сведений об устройстве в DeviceInfoSet.

Возвращаемое значение

SetupDiInstallDeviceInterfaces возвращает значение TRUE , если функция выполнена без ошибок. Если функция завершилась ошибкой, возвращается значение FALSE , а код ошибки для сбоя можно получить, вызвав Метод GetLastError.

Комментарии

SetupDiInstallDeviceInterfaces обрабатывает каждую запись AddInterface в DDInstall. Интерфейсы раздела INF-файла устройства и создает каждый интерфейс путем вызова SetupDiCreateDeviceInterface.

Вызывающий объект SetupDiInstallDeviceInterfaces должен быть членом группы Администраторы.

Примечание Только установщик класса должен вызывать SetupDiInstallDeviceInterfaces и только в тех ситуациях, когда установщик класса должен выполнять операции установки интерфейса устройства после того, как SetupDiInstallDeviceInterfaces завершит операцию установки интерфейса устройства по умолчанию. В таких ситуациях установщик класса должен напрямую вызывать SetupDiInstallDeviceInterfaces , когда установщик обрабатывает запрос DIF_INSTALLINTERFACES. Дополнительные сведения о вызове обработчика по умолчанию см. в разделе Вызов обработчиков кода DIF по умолчанию.
 
Сведения о формате INF-файла см. в разделе Inf File Sections and Directives.

Требования

Требование Значение
Минимальная версия клиента Доступно в Microsoft Windows 2000 и более поздних версиях Windows.
Целевая платформа Персональный компьютер
Верхняя часть setupapi.h (включая Setupapi.h)
Библиотека Setupapi.lib
DLL Setupapi.dll

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

DIF_INSTALLINTERFACES

SetupDiCreateDeviceInterface