共用方式為

Direct3D 11 on 12

  • 發行項

D3D11On12 是一種機制，開發人員可以使用 D3D11 介面和對象來驅動 D3D12 API。 D3D11on12 可讓使用 D3D11 （例如 D2D 文字和 UI） 撰寫的元件與以 D3D12 API 為目標的元件搭配使用。 D3D11on12 也可讓應用程式從 D3D11 累加移植到 D3D12，方法是讓應用程式部分繼續以 D3D11 為目標，以求簡單起見，而其他應用程式則以 D3D12 為目標，以達到效能，同時一律具有完整且正確的轉譯。 D3D11On12 可讓您更輕鬆地使用 Interop 技術來共用資源，並在兩個 API 之間同步處理工作。

初始化 D3D11On12

若要開始使用 D3D11On12，第一個步驟是建立 D3D12 裝置和命令佇列。 這些物件是以初始化方法的輸入的形式提供，D3D11On12CreateDevice。 您可以將此方法視為使用虛構驅動程式類型建立 D3D11 裝置D3D_DRIVER_TYPE_11ON12，其中 D3D11 驅動程式負責建立物件，並將命令清單提交至 D3D12 API。

擁有 D3D11 裝置和立即內容之後，您可以 QueryInterfaceID3D11On12Device 介面的裝置。 這是用於 D3D11 與 D3D12 之間 Interop 的主要介面。 若要讓 D3D11 裝置內容和 D3D12 命令清單在相同的資源上運作，您必須使用 createWrappedResourceAPI建立「包裝資源」。 此方法會「升級」D3D12 資源，以在 D3D11 中瞭解。 包裝的資源會以「已取得」狀態開始，這是由 AcquireWrappedResources 和 ReleaseWrappedResources 方法作的屬性。

範例使用方式

D3D11On12 的一般使用方式是使用 D2D 在 D3D12 後台緩衝區上方轉譯文字或影像。 如需範例程式代碼，請參閱 D3D11On12 範例。 以下是執行此動作的步驟粗略概述：

  • 建立 D3D12 裝置（D3D12CreateDevice）和 D3D12 交換鏈結（CreateSwapChain，並以 ID3D12CommandQueue 作為輸入）。
  • 使用 D3D12 裝置和與輸入相同的命令佇列，建立 D3D11On12 裝置。
  • 擷取交換鏈結回緩衝區，併為每個緩衝區建立 D3D11 包裝的資源。 使用的輸入狀態應該是 D3D12 使用它的最後一種方式（例如RENDER_TARGET），而輸出狀態應該是 D3D12 在 D3D11 完成之後使用它的方式（例如 PRESENT）。
  • 初始化 D2D，並將 D3D11 包裝的資源提供給 D2D 以準備轉譯。

然後，在每個畫面上，執行下列動作：

背景

D3D11On12 有系統地運作。 每個 D3D11 API 呼叫都會經過一般運行時間驗證，並讓其前往驅動程式。 在驅動程式層中，特殊的 11on12 驅動程式會記錄狀態，並將轉譯作業發出至 D3D12 命令清單。 這些命令清單會視需要提交（例如，查詢 GetData 或資源 Map 可能需要排清命令），或由 Flush 要求。 建立 D3D11 物件通常會導致建立對應的 D3D12 物件。 D3D12 不支援某些 D3D11 中的固定函式轉譯作業，例如 GenerateMips 或 DrawAuto，因此 D3D11On12 會使用著色器和其他資源來模擬它們。

對於 Interop，請務必瞭解 D3D11On12 如何與應用程式建立和提供的 D3D12 對象互動。 為了確保工作以正確的順序執行，必須先排清 D3D11 實時內容，才能將其他 D3D12 工作提交至該佇列。 請務必確保提供給 D3D11On12 的佇列必須隨時清空。 這表示，即使 D3D11 轉譯線程無限期封鎖，佇列上的任何等候最終都必須滿足。 謹慎不要依賴 D3D11On12 插入排清或等候時，因為這可能會隨著未來的版本而變更。 此外，D3D11On12 會自行追蹤和作資源狀態。 確保狀態轉換的一致性的唯一方法是使用取得/發行 API 來作狀態追蹤，以符合應用程式的需求。

清除

若要釋放 D3D11On12 包裝的資源，必須依此順序發生兩件事：

  • 必須釋放資源的所有參考，包括資源的任何檢視。
  • 必須進行延後解構處理。 若要確保發生這種情況，最簡單的方式是叫用立即內容 Flush API。

完成這兩個步驟之後，應該釋放包裝資源所採取的任何參考，而 D3D12 資源會成為 D3D12 元件獨佔擁有的資源。 請注意，除非您已經確認 GPU 不再使用資源，否則 D3D12 仍然需要在完全釋放資源之前等候 GPU 完成，因此請務必先保留資源的參考，再執行上述兩個步驟。

當 GPU 使用 D3D111 的延後解構機制完成使用時，將會在適當時間清除所有其他資源或物件。 不過，如果您在 GPU 仍在執行時嘗試釋放 D3D11On12 裝置本身，解構可能會封鎖直到 GPU 完成為止。

局限性

D3D11On12 層會實作非常大的 D3D11 API 子集，但有一些已知的差距（除了實作中的 Bug 可能會導致不正確的轉譯）。

自 Windows 10 版本 1809 起（10.0;組建 17763），只要 D3D11On12 在支援著色器模型 6.0 或更新版本的驅動程式上執行，就可以執行使用介面的著色器。 在舊版 Windows 中，著色器介面功能不會在 D3D11On12 中實作，而嘗試使用此功能會導致錯誤和偵錯訊息。

自 Windows 10 版本 1803 起（10.0;D3D11On12 裝置支援交換鏈結 17134）。 在舊版的 Windows 中，它們不是。

D3D11On12 尚未針對效能進行優化。 相較於標準 D3D11 驅動程式，GPU 額外負荷最小，而且已知記憶體額外負荷很大，可能會有中等 CPU 額外負荷。 因此，不建議針對複雜的 3D 場景使用 D3D11On12，而是建議用於簡單的場景或 2D 轉譯。

蜜蜂屬

組成 11on12 層的 API 會在 11on12 參考中說明。

使用 D3D11on12 逐步解說 D2D

瞭解 Direct3D 12

使用 Direct3D 11、Direct3D 10 和 Direct2D