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

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