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

アドレスからシステム メモリに特殊な目的の診断ヒープを作成します。 作成されたヒープは、GPU 障害またはデバイスが削除されたシナリオの場合でも保持できます。

構文

HRESULT OpenExistingHeapFromAddress(
  [in]  const void *pAddress,
        REFIID     riid,
  [out] void       **ppvHeap
);

パラメーター

[in] pAddress

型: const void*

ヒープの作成に使用されるアドレス。

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 リージョン全体をラップします。

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

要件

   
対象プラットフォーム Windows
ヘッダー d3d12.h
Library D3d12.lib
[DLL] D3d12.dll

関連項目

ID3D12Device3 インターフェイス