Skip to main content
ファイル マッピング オブジェクトからシステム メモリに特殊用途の診断ヒープを作成します。作成されたヒープは、GPU 障害やデバイス削除のシナリオでも保持できます。

構文

パラメーター

hFileMapping
型: HANDLE
ヒープの作成に使用するファイル マッピング オブジェクトへのハンドル。 riid
型: const IID &
ヒープ インターフェイス (ID3D12Heap) のグローバル一意識別子 (GUID)。 ヒープに対するインターフェイスの REFIID または GUID は、__uuidof() マクロを使用して取得できます。たとえば、__uuidof(ID3D12Heap) はヒープに対するインターフェイスの GUID を取得します。 ppvHeap [out]
型: void **
SAL: COM_Outptr メモリ ブロックへのポインター。成功した場合、D3D12 ランタイムは新しく開かれたヒープへのポインターをこのメモリ ブロックに書き込みます。ポインターの型は、指定された riid パラメーターに依存します。

戻り値

型: HRESULT 既存のヒープを開くための十分なメモリがない場合、このメソッドは E_OUTOFMEMORY を返します。その他の可能な戻り値については、Direct3D 12 の戻り値コード を参照してください。

解説

ヒープはシステム メモリに作成され、CPU アクセスを許可します。VirtualAlloc 領域全体をラップします。 ヒープは配置リソースや予約済みリソースに使用でき、他のヒープと同様に直交して使用できます。アプリで選択できないフラグに基づく制限が引き続き存在する可能性があります。

要件

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

関連項目

ID3D12Device3 インターフェイス
最終更新日 2026年8月24日