DismAddDriver 函式

將協力廠商驅動程式 (.inf) 新增至離線 Windows 映像。

語法

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

參數

會話 [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時，會在 DismDriverPackage結構中傳回新的名稱，例如 OEM1.inf。 使用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
程式庫	DismAPI.lib
DLL	DismAPI.dll