本文說明如何在必要時在系統上部署 Direct3D 11 元件。
- 概觀
- Direct3D 11.3
- Direct3D 11.2
- Direct3D 11.1
- D3D11InstallHelper.dll
- D3D11Install.exe
- 整合至安裝程式
- 偵錯秘訣
- 公司設定
- 相關文章
概述
Direct3D 11 API 擴充現有的 Direct3D 10.1 API,支援多線程轉譯和資源建立、計算著色器、硬體鑲嵌、BC6H/BC7 紋理壓縮,以及具有動態著色器連結的 HLSL 著色器模型 5.0。 除了 Direct3D 11 元件之外,DirectX 11 運行時間還包含一些額外的圖形元件:Direct3D 11、DXGI 1.1、10level9 功能層級、WARP10 軟體轉譯裝置、Direct2D、DirectWrite,以及支援 10level9 和 WARP10 的更新 Direct3D 10.1。 關於這些及其他Windows圖形元件的資訊,請參閱 Windows<> 中的
所有這些新圖形元件都內建於 Windows 7 與 Windows Server 2008 R2 作業系統中。 Direct3D 11 API 及相關元件也可透過 Windows Update 的系統更新安裝於 Windows Vista。 此更新需要 Windows Vista 和 Service Pack 2。 因此,啟用自動更新的終端用戶很可能已經安裝了 Direct3D 11 元件,所有 Windows 7 使用者也是如此。
D3D11InstallHelper 範例的設計目的是簡化 Direct3D 11 API 的偵測,如果適用於終端使用者的電腦,將自動安裝系統更新;在需要較新 Service Pack 的情況下,為終端使用者提供手動程序的相關訊息。
注意
HLSL 編譯器(D3DCompile*.dll)及 Direct3D 11 的 D3DX 工具庫(D3DX11*.dll)並非內建於任何版本的 Windows 作業系統中,但可透過現有的 DirectSetup 技術作為應用程式安裝程式的一部分部署;欲了解更多 DirectSetup 的使用資訊,請參見 DirectX Installation for Game Developers。 「Effects 11」作為共享原始碼支援函式庫,網址為 Effects for Direct3D 11 Update,你可以直接將其納入應用程式(類似 DXUT 工具庫)。 因此,它沒有任何額外的執行階段的重新分發要求。
Direct3D 11.3
Windows 10 內建 Direct3D 11.3 API。 如需 Direct3D 11.3 API 中的新功能清單,請參閱 Direct3D 11.3 功能。
Direct3D 11.2
Windows 8.1 與 Windows Server 2012 R2 內建 Direct3D 11.2 API。 如需 Direct3D 11.2 API 中的新功能清單,請參閱 Direct3D 11.2 功能。
Direct3D 11.1
Windows 8 和 Windows Server 2012 內建了 Direct3D 11.1 API。 部分支援 Direct3D 11.1 API 可在安裝 Platform Update for Windows 7 的 Windows 7 或 Windows Server 2008 R2 上使用。 欲了解更多關於Windows 7平台更新的資訊,請參閱平台更新 for Windows 7。
D3D11InstallHelper.dll
D3D11InstallHelper.dll 主機承載偵測 Direct3D 11 元件的核心功能,並在適用時透過 Windows Update 服務執行系統更新。 DLL 不會直接顯示任何訊息或對話框。
DLL 包含下列進入點:
-
CheckDirect3D11狀態
-
此函式會執行必要的檢查,並傳回此電腦上 Direct3D 11 的狀態。 此函式不需要系統管理員許可權。
- D3D11IH_STATUS_INSTALLED狀態表示已在計算機上安裝 Direct3D 11,且已可供使用。
- D3D11IH_STATUS_NOT_SUPPORTED表示此版本的 Windows不支援 Direct3D 11 或相關技術。
- 狀態為 D3D11IH_STATUS_NEED_LATEST_SP 表示使用者應安裝最新的 Windows Vista 服務包。
- 最後,狀態為 D3D11IH_STATUS_REQUIRES_UPDATE 表示系統尚未安裝 Direct3D 11,但系統更新仍適用於此版本的 Windows。
-
DoUpdateForDirect3D11
-
此功能使用 Windows Update API 來執行系統更新,以便在此系統安裝 Direct3D 11(如適用)。 請注意,此功能需要連線 Windows Update 才能成功,並且需要管理員權限。 它會採用選擇性的進度回呼函式和用戶內容指標,並在完成時傳回最終的結果碼。
- D3D11IH_RESULT_SUCCESS結果表示系統更新已套用且已可供使用,而D3D11IH_RESULT_SUCCESS_REBOOT表示系統更新要求計算機在完成之前重新啟動。 請注意,此函式不會排程系統重新啟動。
- D3D11IH_RESULT_NOT_SUPPORTED 表示此版本的 Windows 作業系統不適用於系統更新。 只有在從 CheckDirect3D11Status 取得 D3D11IH_STATUS_REQUIRES_UPDATE 狀態後才呼叫此函式,該結果不應發生。
- D3D11IH_RESULT_UPDATE_NOT_FOUND結果顯示系統更新套件未在Windows Update伺服器上找到。
- 如果Windows Update下載或安裝失敗,結果會回傳D3D11IH_RESULT_UPDATE_DOWNLOAD_FAILED或D3D11IH_RESULT_UPDATE_INSTALL_FAILED。
- 若 Windows Update API 回傳網路連線錯誤,則回傳 D3D11IH_RESULT_WU_SERVICE_ERROR 結果,表示問題可能是間歇性,或與網路設定或防火牆設定有關。 再次嘗試更新函式可能會成功。
欲了解更多關於 Windows Update API 的資訊,請參見 Windows Update 代理 API。
D3D11Install.exe
注意
D3D11Install.exe 需要執行 D3D11InstallHelper.dll。
D3D11Install.exe 是一種工具,用來將 D3D11InstallHelper.dll 作為獨立的安裝程式,並包含使用者介面和終端使用者訊息,以及作為正確使用該 DLL 的範例。 如果已安裝 Direct3D 11,則此程式會以 0 結束,如果系統更新成功套用,而不需要重新啟動系統、需要 Service Pack 安裝,或此電腦不支援 Direct3D 11。 如果成功套用系統更新,而且需要系統重新啟動才能完成,則會傳回 1。 針對其他錯誤狀況會傳回 2。 請注意,此執行檔需要管理員權限才能執行,且在啟用 UAC 的 Windows Vista 或 Windows 7 上執行時,它有一個清單請求升遷。 D3D11Install.exe 可作為部署 Direct3D 11 更新的獨立工具,也可以由安裝程式直接使用。
它支援下列命令列參數:
-
/安靜
-
不顯示任何訊息、提示、進度對話框或錯誤訊息。
-
/被動
-
不會顯示任何訊息、提示或錯誤訊息,但會顯示進度對話方塊。
-
/最小化
-
只顯示最少的提示。
-
/y
-
禁止在標準和最小安裝中,根據需要和適用性,提示確認安裝更新。
-
/langid 十進位
-
強制顯示使用者訊息和對話框資源時要使用的語言標識碼。 默認值為 1024,它會使用系統預設語言設定。
-
/吳
-
強制使用 Windows Update 而非系統預設,這可能是在受管理伺服器上運行的 Windows Server Update Services(WSUS)或其他非標準配置。
整合到安裝程式中
為符合 Support Easy Installation Technical Requirement 3.1 for Games for Windows,必須在安裝過程的初期即對終端使用者呈現相關提示,並確保不會出現多個與 UAC 相關的權限提升提示。 達成此目標有三個基本選擇:
- 最基本的方法是使用命令行參數 /minimal來執行 D3D11Install.exe。 必須及早在安裝程式 Q&A 中完成此步驟,並且安裝應使用傳回值 1 來指示應在安裝結束時排定重新啟動。 執行程式需要系統管理許可權。
- 直接使用 D3D11InstallHelper.dll 來偵測是否需要進行更新,並提供 D3D11IH_STATUS_NEED_LATEST_SP 狀態所需的任何最終使用者訊息,其解析需要手動操作。 D3D11IH_STATUS_NOT_SUPPORTED 的狀態結果可用來控制 Direct3D 11 相關資產的安裝,或作為僅適用於 Direct3D 11 應用程式的錯誤條件,但對最終使用者來說不一定是有用的訊息。 針對狀態D3D11IH_STATUS_REQUIRES_UPDATE,安裝程式可以直接使用 DLL 進入點 DoUpdateForDirect3D11 來執行更新,並處理各種產生的使用者訊息。 藉由檢查 [D3D11Install.exe] 對話框和字串數據表資源,即可找到標準訊息的範例。 更新進入點需要系統管理員許可權。
- 混合式方法是使用 D3D11InstallHelper.dll檢查狀態,並在狀態代碼D3D11IH_STATUS_NEED_LATEST_SP或D3D11IH_STATUS_REQUIRES_UPDATE的情況下,D3D11Install.exe 可以使用參數 /minimal 和 /y 來執行,視需要顯示對話框或執行更新。 這些步驟應在安裝程式初期執行,通常是在 Q&A 之後立即執行,而執行可執行檔需要系統管理許可權。
整合到 InstallShield
使用 D3D11InstallHelper 範例,輕鬆地處理 InstallShield 的 InstallScript 的 Direct3D 11 部署。 使用 InstallScript 與 InstallShield 整合所需的步驟如下(使用上一節所述的方法 3):
在 InstallShield 編輯器中開啟 InstallScript 專案。
將 D3D11InstallHelper.dll 和 D3D11Install.exe 新增至 支援檔案中的專案。
將檔案加入 InstallShield Project
- 在 [安裝設計工具] 索引卷標上,點擊左側瀏覽窗格中的 [行為和邏輯] 下的 [支援檔案/看板]。
- 按兩下 [Language Independent],然後在 [檔案] 視窗中按下滑鼠右鍵,然後選取 [[插入檔案]。 瀏覽以新增 D3D11InstallHelper.dll 並 D3D11Install.exe。 這些檔案的預設位置為:SDK root\Samples\C++\Misc\Bin\x86
在 InstallScript 總管中,按一下位於左側瀏覽窗格 行為和邏輯 下方的 InstallScript 檔案(通常是 Setup.rul),該檔案將呼叫 DLL 或可執行檔。
將下列 InstallScript 貼到靠近頂端的檔案中:
#define D3D11IH_STATUS_INSTALLED 0 #define D3D11IH_STATUS_NOT_SUPPORTED 1 #define D3D11IH_STATUS_REQUIRES_UPDATE 2 #define D3D11IH_STATUS_NEED_LATEST_SP 3 #define D3D11IH_STATUS_ERROR -1 原型編號 D3D11InstallHelper.CheckDirect3D11StatusIS(:
#define D3D11IH_RESULT_SUCCESS 0 #define D3D11IH_RESULT_SUCCESS_REBOOT 1 #define D3D11IH_RESULT_NOT_SUPPORTED 2 #define D3D11IH_RESULT_UPDATE_NOT_FOUND 3 #define D3D11IH_RESULT_UPDATE_DOWNLOAD_FAILED 4 #define D3D11IH_RESULT_UPDATE_INSTALL_FAILED 5 #define D3D11IH_RESULT_WU_SERVICE_ERROR 6 #define D3D11IH_RESULT_ERROR -1 原型編號 D3D11InstallHelper.DoUpdateForDirect3D11IS(BOOL):```
將下列 InstallScript 貼到 OnFirstUIBefore 函式中的檔案中,就在傳回 0 之前:
Dlg_D3D11: UseDLL( SUPPORTDIR ^ "D3D11InstallHelper.DLL" ); nResult = D3D11InstallHelper.CheckDirect3D11StatusIS(); UnUseDLL( SUPPORTDIR ^ "D3D11InstallHelper.DLL" ); if ( nResult = D3D11IH_STATUS_REQUIRES_UPDATE || nResult = D3D11IH_STATUS_NEED_LATEST_SP) then nResult = LaunchAppAndWait( SUPPORTDIR^"D3D11Install.exe", "/minimal /y", WAIT); if ( nResult < 0 ) then MessageBox("Unable to launch D3D11Install.exe", SEVERE); elseif ( nResult == 1 ) then BATCH_INSTALL = 1; endif; endif;
整合到 MSI 套件中
以下是使用 MSI 自定義動作整合 Direct3D 11 部署所需的步驟的高階描述(使用本主題稍早所述的方法 3):
- 將屬性新增至名為 RelativePathToD3D11IH 的 MSI 屬性數據表,其中包含安裝期間 D3D11Install.exe 和 D3D11InstallHelper.dll 的相對路徑(這通常是在媒體映像中)。 這也會將 MSI 屬性 D3D11IH_STATUS 設為 CheckDirect3D11Status 傳回的狀態,該狀態是一個字串屬性,等於列舉符號或 "ERROR"。
- 在 CostFinalize 巨集指令之後,呼叫 D3D11InstallHelper.dll 函數 SetD3D11InstallMSIProperties 作為立即自訂動作,以設定其他自訂動作的正確 MSI 屬性。
- 安裝時,請在呼叫 DoD3D11InstallUsingMSID3D11InstallHelper.dll 函式的 InstallFiles 動作之後觸發延後自定義動作。 自定義動作必須設定旗標 msidbCustomActionTypeNoImpersonate,以便在提升的權限中執行。
- 在 InstallFinalize 動作之後,如有需要,呼叫 FinishD3D11InstallUsingMSI 的 D3D11InstallHelper.dll 函式作為立即自定義動作,以處理成功的重新啟動請求結果代碼。
下列指示會詳細說明此程式,其描述可使用 MSI 編輯器完成的程式,例如 Orca 編輯器。 有些 MSI 編輯器有精靈,可簡化其中一些設定步驟。
設定 MSI 套件以與 D3D11InstallHelper.dll 整合
在 Orca 中開啟 MSI 套件。
將下表中顯示的數據列新增至 MSI 套件中的二進位數據表。
名字 數據 D3D11IH DLL\D3D11InstallHelper.dll 的檔案路徑 注意
此檔案會內嵌在 MSI 套件中,因此您必須在每次重新編譯 D3D11InstallHelper.dll時執行此步驟。
將下表中顯示的數據列新增至 MSI 套件中的 CustomAction 數據表。
行動 類型 源 目標 Direct3D11SetProps msidbCustomActionTypeDll + msidbCustomActionTypeBinaryData + msidbCustomActionTypeContinue = 65 D3D11IH SetD3D11InstallMSIProperties Direct3D11DoInstall msidbCustomActionTypeDll + msidbCustomActionTypeBinaryData + msidbCustomActionTypeContinue + msidbCustomActionTypeInScript + msidbCustomActionTypeNoImpersonate = 3137 D3D11IH DoD3D11InstallUsingMSI Direct3D11Finish msidbCustomActionTypeDll + msidbCustomActionTypeBinaryData + msidbCustomActionTypeContinue = 65 D3D11IH FinishD3D11InstallUsingMSI 將下表中針對 Action、Condition 和 Sequence 顯示的值新增至 MSI 套件中的 InstallExecuteSequence 數據表。
行動 條件 序列 註釋 Direct3D11SetProps 1016 序列號會在 CostFinalize 之後不久執行動作。 Direct3D11DoInstall 未安裝 4004 此自定義動作只會在所有使用者的新安裝期間發生。 序號會將動作放在 InstallFiles 之後和復原之後。 Direct3D11Finish 6615 序號會將動作放在 InstallFinalize 之後。 將下表中顯示的數據列新增至 MSI 套件中的 Property 數據表。
財產 價值 RelativePathToD3D11IH 包含 D3D11Install.exe 和 D3D11InstallHelper.dll 的相對檔案路徑 注意
路徑所指定的位置相對於安裝路徑所指定的位置,例如 「redist\」。
儲存 MSI 套件。 欲了解更多關於 MSI 套件與 Windows 安裝程式的詳細資訊,請參閱 Windows 安裝程式。
偵錯秘訣
D3D11InstallHelper.dll 和 D3D11Install.exe 都可以在 Visual Studio 中使用 Debug 設定建置,這些版本會將訊息印出到標準的除錯輸出機制Windows。
公司設定
D3D11InstallHelper 範例設計為透過 Windows Update 標準部署,這是消費者安裝遊戲最常見的情境。 然而,許多為發行商及開發工作室工作的遊戲開發者,是在企業環境中進行,這些環境擁有本地管理的伺服器,透過使用 Windows Server Update Services(WSUS)技術提供軟體更新。 在這種環境中,本地IT系統管理員擁有審批控制權,決定哪些更新可以在公司網路中的電腦上提供,且消費者版本的標準更新 KB 971644 不可用。
在公司/企業設定中部署 DirectX 11 有三個基本解決方案:
- 在某些設定中,可以直接檢查 Windows Update,而非使用本地管理的 WSUS 伺服器。 因此,D3D11InstallHelper 支援 /wu 命令行參數。 然而,並非所有企業網路都允許連接公共的 Microsoft 伺服器。
- 本機 IT 系統管理員可以核准 KB 971512,這是從 WSUS 部署的企業支援更新,其中包含 Direct3D 11 API。 這是標準使用者在完全鎖定的環境中取得 Direct3D 11 更新的唯一選項。
- 另外,也可以手動安裝 KB 971512。
遊戲玩家的電腦只能從本地管理的 WSUS 伺服器獲取更新是極為罕見的,只有在大型組織工作的開發人員才可能處於這種環境中。