Skip to main content
配置済みリソースおよび予約済みリソースで使用できるヒープを作成します。

構文

パラメーター

pDesc [in]
型: const D3D12_HEAP_DESC *
ヒープを記述する定数 D3D12_HEAP_DESC 構造体へのポインター。 riid [in]
型: const IID &
ppvHeap で返されるヒープ インターフェイスのグローバル一意識別子 (GUID) への参照。 riidResource は最も一般的には ID3D12HeapGUID ですが、任意のインターフェイスの GUID である可能性があります。リソース オブジェクトがこの GUID のインターフェイスをサポートしていない場合、作成は E_NOINTERFACE で失敗します。 ppvHeap [out, optional]
型: void **
作成されたヒープ オブジェクトへの要求されたインターフェイス ポインターを受け取るメモリ ブロックへの省略可能なポインター。 ppvHeapnullptr にして機能テストを有効にできます。ppvHeapnullptr の場合、オブジェクトは作成されず、pDesc が有効な場合は S_FALSE が返されます。

戻り値

型: HRESULT 関数が成功した場合、S_OK を返します。それ以外の場合は、HRESULT エラー コード を返します。 その他の戻り値については、Direct3D 12 の戻りコード を参照してください。

解説

CreateHeap は、配置済みリソースおよび予約済みリソースで使用できるヒープを作成します。 ヒープの最後の参照を解放する前に、アプリケーションは GPU がこのヒープを読み書きしないことを保証する必要があります。 配置済みリソース オブジェクトは、それが作成されるヒープへの参照を保持しますが、予約済みリソースはヒープへの各マッピングに対する参照を保持しません。

要件

ヘッダー: d3d12_xs.h または d3d12_x.h
ライブラリ: d3d12_xs.lib または d3d12_x.lib
サポートされているプラットフォーム: XBOX Series 本体および XBOX One ファミリ

関連項目

ID3D12Device 共有ヒープ
最終更新日 2026年8月24日