Функция DismAddDriver

Статья
06/20/2023

Добавляет сторонний драйвер (.inf) в автономный образ Windows.

Синтаксис

HRESULT WINAPI DismAddDriver(
  _In_ DismSession Session,
  _In_ PCWSTR      DriverPath,
  _In_ BOOL        ForceUnsigned
);

Параметры

Сеанс [вход]
Допустимое DismSession. DismSession должен быть связан с изображением. Вы можете связать сеанс с изображением с помощью функции DismOpenSession .

DriverPath [in]
Относительный или абсолютный путь к INF-файлу драйвера.

ForceUnsigned [in]
Логическое значение, указывающее, следует ли принимать неподписанные драйверы в образ x64. Неподписанные драйверы будут автоматически добавлены в образ x86.

Значение	Описание
TRUE	Добавление неподписанных драйверов в образ x64.
Ложь.	Не добавляйте неподписанные драйверы в образ x64.

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

В случае успешного выполнения возвращает S_OK .

Примеры

В этом примере добавляемый драйвер находится на техническом компьютере в папке C:\drivers\. Драйвер имеет имя файла usb.inf на техническом компьютере, но в целевом образе переименован в "OEM1.inf" или "OEM2.inf". Нумерирование файлов OEMx.inf зависит от количества добавленных драйверов. Новое имя, например OEM1.inf, возвращается в структуре DismDriverPackage при вызове DismGetDrivers. При использовании DismGetDriverInfo следует использовать новое имя OEM1.inf, чтобы указать DriverPath.

HRESULT hr = S_OK;
hr = DismAddDriver(Session, L"C:\\Drivers\\usb.inf", FALSE);

Требования

Требование	Описание
Поддерживаемые платформы узлов	API DISM можно использовать в любой операционной системе, поддерживаемой комплектом средств для развертывания и оценки Windows (Windows ADK). Дополнительные сведения см. в техническом справочнике по Windows ADK.
Поддерживаемые платформы образов	Windows 7, Windows Server 2008 R2, Windows PE 3.0, Windows 8, Windows Server 2012, среда предустановки Windows (Windows PE) 4.0, Windows 8.1, Windows Server 2012 R2, Windows 10, Windows Server 2016
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Заголовок	DismAPI.h
Библиотека	DismAPI.lib
DLL	DismAPI.dll

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