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

Статья
03/01/2024

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

Синтаксис

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

Параметры

[in] DeviceInfoSet

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

[in] DeviceInfoData

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

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

Функция возвращает ЗНАЧЕНИЕ TRUE , если оно выполнено успешно. В противном случае возвращается значение FALSE , а зарегистрированная ошибка может быть получена с помощью вызова Метода GetLastError.

Вызывающий объект SetupDiInstallDriverFiles должен быть членом группы Администраторы, если эта функция используется для установки файлов. Однако если эта функция используется для создания очереди файлов, членство в группе Администраторы не требуется.

Примечание Только установщик класса должен вызывать SetupDiInstallDriverFiles и только в тех ситуациях, когда установщик класса должен выполнять операции установки файлов драйверов после того , как SetupDiInstallDriverFiles завершит установку файла драйвера по умолчанию. В таких ситуациях установщик класса должен напрямую вызывать SetupDiInstallDriverFiles , когда установщик обрабатывает запрос DIF_INSTALLDEVICEFILES. Дополнительные сведения о вызове обработчика по умолчанию см. в разделе Вызов обработчиков кода DIF по умолчанию.

Операция SetupDiInstallDriverFiles аналогична функции SetupDiInstallDevice . Однако эта функция выполняет только операции копирования файлов, выполняемые SetupDiInstallDevice.

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

Эта функция обрабатывает записи CopyFiles, Delfiles и Renfiles в выбранном INF-файле.

DeviceInfoSet должен содержать только элементы на локальном компьютере.

Требования

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

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

SetupDiCallClassInstaller

SetupDiInstallDevice

Поделиться через