ID3D12Device3::OpenExistingHeapFromFileMapping メソッド (d3d12.h)

ファイルマッピングオブジェクトからシステムメモリに特殊な目的の診断ヒープを作成します。作成されたヒープは、GPU 障害またはデバイスが削除されたシナリオが発生した場合でも保持できます。

構文

HRESULT OpenExistingHeapFromFileMapping(
        HANDLE hFileMapping,
        REFIID riid,
  [out] void   **ppvHeap
);

hFileMapping

型: HANDLE

ヒープの作成に使用するファイルマッピングオブジェクトへのハンドル。

riid

型: REFIID

ヒープインターフェイス (ID3D12Heap) のグローバル一意識別子 (GUID)。

ヒープへのインターフェイスの REFIID ( GUID) は、 __uuidof() マクロを使用して取得できます。たとえば、 __uuidof(ID3D12Heap) は、インターフェイスの GUID を ヒープに取得します。

[out] ppvHeap

型: void**

SAL: COM_Outptr

メモリブロックへのポインター。成功すると、D3D12 ランタイムは、新しく開いたヒープへのポインターをメモリブロックに書き込みます。ポインターの型は、指定された riid パラメーターによって異なります。

型: HRESULT

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

ヒープはシステムメモリに作成され、CPU アクセスが許可されます。 VirtualAlloc リージョン全体がラップされます。

ヒープは、他のヒープと同様に、配置されたリソースと予約済みリソースに使用できます。制限は、アプリで選択できないフラグに基づいて引き続き存在する可能性があります。