> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenExistingHeapFromFileMapping

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

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

## 構文

```cpp theme={null}
HRESULT OpenExistingHeapFromFileMapping(
    HANDLE hFileMapping,
    const IID & riid,
    void  ppvHeap
)
```

### パラメーター

*hFileMapping*\
型: HANDLE

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

*riid*\
型: const IID &

ヒープ インターフェイス ([ID3D12Heap](https://docs.xbox.com/ja-jp/reference/graphics/d3d12/interfaces/id3d12heap/id3d12heap_public.md)) のグローバル一意識別子 (**GUID**)。

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

*ppvHeap \[out]*\
型: void \*\*

[SAL](https://learn.microsoft.com/en-us/visualstudio/code-quality/annotating-function-parameters-and-return-values?view=vs-2015\&preserve-view=true): `COM_Outptr`

メモリ ブロックへのポインター。成功した場合、D3D12 ランタイムは新しく開かれたヒープへのポインターをこのメモリ ブロックに書き込みます。ポインターの型は、指定された **riid** パラメーターに依存します。

### 戻り値

型: HRESULT

既存のヒープを開くための十分なメモリがない場合、このメソッドは **E\_OUTOFMEMORY** を返します。その他の可能な戻り値については、[Direct3D 12 の戻り値コード](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12-graphics-reference-returnvalues) を参照してください。

## 解説

ヒープはシステム メモリに作成され、CPU アクセスを許可します。VirtualAlloc 領域全体をラップします。

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

## 要件

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

## 関連項目

[ID3D12Device3 インターフェイス](https://docs.xbox.com/ja-jp/reference/graphics/d3d12_x/interfaces/id3d12device3/id3d12device3.md)


## Related topics

- [OpenExistingHeapFromAddress](https://docs.xbox.com/ja-jp/reference/graphics/d3d12/interfaces/id3d12device3/methods/id3d12device3_openexistingheapfromaddress_public.md)
- [D3D12_FEATURE_DATA_EXISTING_HEAPS](https://docs.xbox.com/ja-jp/reference/graphics/d3d12/structs/d3d12_feature_data_existing_heaps_public.md)
- [OpenFile](https://docs.xbox.com/ja-jp/reference/system/dstorage/interfaces/IDStorageFactoryX/methods/idstoragefactoryx_openfile.md)
- [Update Open Id Connection](https://docs.xbox.com/api-reference/authentication/update-open-id-connection.md)
- [OpenSharedHandle](https://docs.xbox.com/ja-jp/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_opensharedhandle_public.md)