> ## 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.

# CreateHeap

> 배치된 리소스와 예약된 리소스에 사용할 수 있는 힙을 만듭니다.

배치된 리소스와 예약된 리소스에 사용할 수 있는 힙을 만듭니다.

## 구문

```cpp theme={null}
HRESULT CreateHeap(
    const D3D12_HEAP_DESC  pDesc,
    const IID & riid,
    void  ppvHeap
)
```

### 매개 변수

*pDesc \[in]*\
형식: const D3D12\_HEAP\_DESC \*

힙을 설명하는 상수 **D3D12\_HEAP\_DESC** 구조체에 대한 포인터입니다.

*riid \[in]*\
형식: const IID &

*ppvHeap*에서 반환할 힙 인터페이스의 전역 고유 식별자(**GUID**)에 대한 참조입니다.

*riidResource*는 가장 일반적으로 [ID3D12Heap](/reference/graphics/d3d12/interfaces/id3d12heap/id3d12heap_public)의 **GUID**이지만, 모든 인터페이스의 **GUID**일 수 있습니다. 리소스 객체가 이 **GUID**에 대한 인터페이스를 지원하지 않으면 생성이 **E\_NOINTERFACE**로 실패합니다.

*ppvHeap \[out, optional]*\
형식: void \*\*

생성된 힙 객체에 대한 요청된 인터페이스 포인터를 받는 메모리 블록에 대한 선택적 포인터입니다.

*ppvHeap*은 기능 테스트를 활성화하려면 `nullptr`일 수 있습니다. *ppvHeap*이 `nullptr`인 경우 객체가 생성되지 않으며, *pDesc*가 유효하면 **S\_FALSE**가 반환됩니다.

### 반환 값

형식: HRESULT

함수가 성공하면 **S\_OK**를 반환합니다. 그렇지 않으면 [**HRESULT**](https://learn.microsoft.com/en-us/windows/desktop/com/structure-of-com-error-codes) [오류 코드](https://learn.microsoft.com/en-us/windows/win32/com/com-error-codes-10)를 반환합니다.

| 반환 값           | 설명                |
| -------------- | ----------------- |
| E\_OUTOFMEMORY | 힙을 만들 메모리가 부족합니다. |

다른 가능한 반환 값은 [Direct3D 12 반환 코드](https://learn.microsoft.com/en-us/windows/win32/direct3d12/d3d12-graphics-reference-returnvalues)를 참조하세요.

## 설명

**CreateHeap**은 배치된 리소스와 예약된 리소스에 사용할 수 있는 힙을 만듭니다.

힙에 대한 마지막 참조를 해제하기 전에 애플리케이션은 GPU가 이 힙을 더 이상 읽거나 쓰지 않도록 해야 합니다.

배치된 리소스 객체는 생성된 힙에 대한 참조를 보유하지만, 예약된 리소스는 힙에 대한 각 매핑에 대해 참조를 보유하지 않습니다.

## 요구 사항

**헤더:** d3d12\_xs.h 또는 d3d12\_x.h\
**라이브러리:** d3d12\_xs.lib 또는 d3d12\_x.lib\
**지원 플랫폼**: XBOX Series 콘솔 및 XBOX One 제품군

## 함께 보기

[ID3D12Device](/reference/graphics/d3d12_x/interfaces/id3d12device/id3d12device)

[공유 힙](https://learn.microsoft.com/en-us/windows/win32/direct3d12/shared-heaps)


## Related topics

- [CreateHeap1 (XBOX Series 콘솔)](/ko/reference/graphics/d3d12/interfaces/id3d12device4/methods/id3d12device4_createheap1_public.md)
- [D3D12_FEATURE_DATA_EXISTING_HEAPS](/ko/reference/graphics/d3d12/structs/d3d12_feature_data_existing_heaps_public.md)
- [CreateDescriptorHeap](/ko/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createdescriptorheap_public.md)
- [CreateQueryHeap](/ko/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createqueryheap_public.md)
- [ApuCreateHeap](/ko/reference/audio/apu/functions/apucreateheap.md)