構文
パラメーター
pHeap型: ID3D12Heap * リソースが配置されるヒープを表す ID3D12Heap インターフェイスへのポインター。 HeapOffset
型: UINT64 リソースへのオフセット (バイト単位)。HeapOffset はリソースのアライメントの倍数である必要があり、HeapOffset とリソース サイズの合計はヒープ サイズ以下である必要があります。テクスチャ リソースのサイズを理解するには、GetResourceAllocationInfo を使用する必要があります。 pDesc
型: const D3D12_RESOURCE_DESC1 * リソースを記述する 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 は NULL でなければなりません。 NumCastableFormats
型: UINT32 pCastableFormats 内の要素の数。 pCastableFormats
型: DXGI_FORMAT * このリソースがキャスト可能な DXGI_FORMAT 構造体の連続した配列。 riid
型: const IID & リソース インターフェイスのグローバル一意識別子 (GUID)。これは入力パラメーターです。 リソースのインターフェイスの REFIID または GUID は、
__uuidof マクロを使用して取得できます。たとえば、__uuidof(ID3D12Resource) は、リソースのインターフェイスの GUID を取得します。riid は最も一般的には ID3D12Resource の GUID ですが、任意のインターフェイスの GUID である可能性があります。リソース オブジェクトがこの GUID のインターフェイスをサポートしていない場合、作成は E_NOINTERFACE で失敗します。
ppvResource型: void ** リソースへのポインターを受け取るメモリ ブロックへのポインター。ppvResource を NULL にして機能テストを有効にできます。ppvResource が NULL の場合、オブジェクトは作成されず、pResourceDesc およびその他のパラメーターが有効な場合は S_FALSE が返されます。
戻り値
型: HRESULT リソースを作成するのに十分なメモリがない場合、このメソッドは E_OUTOFMEMORY を返します。その他の戻り値については、Direct3D 12 の戻りコード を参照してください。解説
ID3D12Device::CreatePlacedResource の 解説 を参照してください。要件
ヘッダー: d3d12_xs.hライブラリ: d3d12_xs.lib
サポートされているプラットフォーム: XBOX Series 本体