ID3D12Device：：CreateHeap 方法 (d3d12.h)

  • 發行項

建立可與放置的資源和保留資源搭配使用的堆積。

語法

HRESULT CreateHeap(
  [in]            const D3D12_HEAP_DESC *pDesc,
  [in]            REFIID                riid,
  [out, optional] void                  **ppvHeap
);

參數

[in] pDesc

類型：const D3D12_HEAP_DESC*

描述堆積之常數 D3D12_HEAP_DESC 結構的指標。

[in] riid

類型： REFIID

要傳回ppvHeap中之堆積介面之全域唯一識別碼的參考 (GUID) 。

雖然riidResource通常是ID3D12Heap的GUID，但它可能是任何介面的GUID。 如果資源物件不支援此 GUID的介面，則建立會失敗並 E_NOINTERFACE。

[out, optional] ppvHeap

類型： void**

記憶體區塊的選擇性指標，可接收所建立堆積物件的要求介面指標。

ppvHeap 可以是 nullptr ，以啟用功能測試。 當ppvHeap為 nullptr 時，不會建立任何物件，而且pDesc有效時會傳回S_FALSE。

傳回值

類型： HRESULT

如果函式成功，它會 傳回S_OK。 否則，它會傳回 HRESULT錯誤碼。

傳回值 描述
E_OUTOFMEMORY 記憶體不足，無法建立堆積。

如需其他可能的傳回值，請參閱 Direct3D 12 傳回碼 。

備註

CreateHeap 會建立可用於放置資源和保留資源的堆積。

在釋放堆積的最終參考之前，您的應用程式必須確定 GPU 將不再讀取或寫入此堆積。

放置的資源物件會保存所建立堆積上的參考;但保留的資源不會保存對堆積所做的每個對應參考。

需求

   
目標平台 Windows
標頭 d3d12.h
程式庫 D3D12.lib
Dll D3D12.dll

另請參閱

ID3D12Device

共用堆積