跳轉到主要內容
建立已保留且尚未對應至堆積中任何頁面的資源。 需要 DirectX 12 Agility SDK 1.7 或更新版本。

語法

參數

pDesc
類型:const D3D12_RESOURCE_DESC *
D3D12_RESOURCE_DESC 結構的指標,描述資源。 InitialLayout
類型:D3D12_BARRIER_LAYOUT
紋理資源的初始配置;緩衝區則為 D3D12_BARRIER_LAYOUT::D3D12_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
類型:UINT32
pCastableFormats 中的元素數目。 pCastableFormats
類型:DXGI_FORMAT *
此資源可轉換成的 DXGI_FORMAT 結構的連續陣列。 riid [in]
類型:const IID &
要在 ppvResource 中傳回之資源介面的全域唯一識別碼 (GUID) 參考。請參閱備註。 雖然 riidResource 最常是 ID3D12Resource 的 GUID,但它可以是任何介面的 GUID。如果資源物件不支援此 GUID 的介面,則建立會失敗並傳回 E_NOINTERFACE。 ppvResource
類型:void **
記憶體區塊的選擇性指標,該區塊會接收所建立資源物件的要求介面指標。 ppvResource 可以是 nullptr,以啟用功能測試。當 ppvResource 為 nullptr 時,不會建立任何物件,且當 pDesc 有效時會傳回 S_FALSE。

傳回值

類型:HRESULT 如果函式成功,會傳回 S_OK。否則會傳回 HRESULT 錯誤碼。 如需其他可能的傳回值,請參閱 Direct3D 12 傳回碼。

備註

請參閱 ID3D12Device.CreateReservedResource 的備註。

需求

標頭: d3d12_xs.h
程式庫: d3d12_xs.lib
支援的平台:XBOX Series 主機

另請參閱

CreateCommittedResource CreatePlacedResource ID3D12Device10
最後修改於 2026年10月6日