DismAddDriver 函数

将第三方驱动程序 (.inf) 添加到脱机 Windows 映像。

语法

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

参数

Session [in]
一个有效的 DismSession。 DismSession 必须关联一个映像。 你可以使用 DismOpenSession 函数将会话与映像关联。

DriverPath [in]
驱动程序 .inf 文件的相对或绝对路径。

ForceUnsigned [in]
一个布尔值，指定是否接受基于 x64 映像的未签名驱动程序。 未签名的驱动程序将自动添加到基于 x86 的映像。

值	说明
TRUE	将未签名的驱动程序添加到基于 x64 的映像。
FALSE	不要将未签名的驱动程序添加到基于 x64 的映像。

返回值

成功时返回 S_OK 。

示例

在此示例中，要添加的驱动程序位于技术人员计算机上的文件夹 C:\drivers\ 中。 驱动程序在技术人员计算机上具有文件名 usb.inf，但在目标映像中重命名为“OEM1.inf”或“OEM2.inf”。 OEMx.inf 文件的编号取决于添加的驱动程序的数量。 调用 DismGetDrivers 时，新名称（例如 OEM1.inf）会以 DismDriverPackage 结构返回。 使用 DismGetDriverInfo 时，应该使用新名称 OEM1.inf 来指定 DriverPath。

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

要求

要求	说明
支持的主机平台	DISM API 可在 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
Library	DismAPI.lib
DLL	DismAPI.dll