共用方式為

ID3D12Device10：：CreateReservedResource2 方法 （d3d12.h）

  • 發行項

建立保留的資源，且尚未對應至堆積中的任何頁面。

需要 DirectX 12 Agility SDK 1.7 或更新版本。

語法

HRESULT CreateReservedResource2(
       const D3D12_RESOURCE_DESC      *pDesc,
       D3D12_BARRIER_LAYOUT           InitialLayout,
       const D3D12_CLEAR_VALUE        *pOptimizedClearValue,
       ID3D12ProtectedResourceSession *pProtectedSession,
       UINT32                         NumCastableFormats,
       const DXGI_FORMAT              *pCastableFormats,
  [in] REFIID                         riid,
       void                           **ppvResource
);

參數

pDesc

類型：const D3D12_RESOURCE_DESC*

描述資源之 D3D12_RESOURCE_DESC 結構的指標。

InitialLayout

紋理資源的初始配置;D3D12_BARRIER_LAYOUT：:D 3D12_BARRIER_LAYOUT_UNDEFINED 緩衝區。

pOptimizedClearValue

類型：const D3D12_CLEAR_VALUE*

指定描述純色預設值的 D3D12_CLEAR_VALUE 結構。

pOptimizedClearValue 指定最理想的清除作業值。 當建立的資源是具有 D3D12_RESOURCE_FLAG_ALLOW_RENDER_TARGET 或 D3D12_RESOURCE_FLAG_ALLOW_DEPTH_STENCIL 旗標的紋理時，您應該選擇最常呼叫清除作業的值。 您可以使用其他值呼叫清除作業，但當值符合傳遞至資源建立的值時，這些作業不會那麼有效率。

當您使用 D3D12_RESOURCE_DIMENSION_BUFFER時，必須將 pOptimizedClearValue 設定為 nullptr。

pProtectedSession

類型：ID3D12ProtectedResourceSession*

對象的選擇性指標，表示內容保護的會話。 如果提供，則此會話表示應該保護資源。 您可以呼叫 ID3D12Device4：：CreateProtectedResourceSession來取得 ID3D12ProtectedResourceSession。

NumCastableFormats

pCastableFormats 中的項目數目。

pCastableFormats

這個資源可以轉換成的連續 DXGI_FORMAT 結構陣列。

[in] riid

類型：REFIID

要傳回 ppvResource中之資源介面之全域唯一標識碼 （GUID） 的參考。 請參閱 。

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

ppvResource

類型：void**

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

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

傳回值

類型：HRESULT

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

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

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

言論

如需 ID3D12Device.CreateReservedResource，請參閱 備註。

要求

要求 價值
目標平臺 窗戶
標頭 d3d12.h
連結庫 D3d12.lib
DLL D3d12.dll

另請參閱

CreateCommittedResource

CreatePlacedResource

ID3D12Device10