> ## 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/ko/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/ko/reference/graphics/d3d12_x/interfaces/id3d12device3/id3d12device3.md)


## Related topics

- [OpenExistingHeapFromAddress](https://docs.xbox.com/ko/reference/graphics/d3d12/interfaces/id3d12device3/methods/id3d12device3_openexistingheapfromaddress_public.md)
- [D3D12_FEATURE_DATA_EXISTING_HEAPS](https://docs.xbox.com/ko/reference/graphics/d3d12/structs/d3d12_feature_data_existing_heaps_public.md)
- [OpenFile](https://docs.xbox.com/ko/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/ko/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_opensharedhandle_public.md)