> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.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*<br />형식: HANDLE

힙을 만드는 데 사용할 파일 매핑 객체에 대한 핸들입니다.

*riid*<br />형식: const IID &

힙 인터페이스([ID3D12Heap](/reference/graphics/d3d12/interfaces/id3d12heap/id3d12heap_public))에 대한 전역 고유 식별자(**GUID**)입니다.

힙에 대한 인터페이스의 **REFIID** 또는 **GUID**는 **\_\_uuidof()** 매크로를 사용하여 얻을 수 있습니다. 예를 들어 \*\*\_\_uuidof(ID3D12Heap)\*\*은 힙에 대한 인터페이스의 **GUID**를 검색합니다.

*ppvHeap \[out]*<br />형식: void \*\*

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

메모리 블록에 대한 포인터입니다. 성공 시 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<br />**라이브러리:** d3d12\_xs.lib 또는 d3d12\_x.lib<br />**지원 플랫폼**: XBOX Series 콘솔 및 XBOX One 제품군

## 함께 보기

[ID3D12Device3 인터페이스](/reference/graphics/d3d12_x/interfaces/id3d12device3/id3d12device3)


## Related topics

- [OpenExistingHeapFromAddress](/ko/reference/graphics/d3d12/interfaces/id3d12device3/methods/id3d12device3_openexistingheapfromaddress_public.md)
- [D3D12_FEATURE_DATA_EXISTING_HEAPS](/ko/reference/graphics/d3d12/structs/d3d12_feature_data_existing_heaps_public.md)
- [OpenSharedHandle](/ko/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_opensharedhandle_public.md)
- [IDStorageFactoryX::OpenFile](/ko/reference/system/dstorage/interfaces/IDStorageFactoryX/methods/idstoragefactoryx_openfile.md)
- [IDStorageFileX](/ko/reference/system/dstorage/interfaces/IDStorageFileX/idstoragefilex.md)