ID3D12Device::CreateHeap 메서드(d3d12.h)

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

구문

HRESULT CreateHeap(
  [in]            const D3D12_HEAP_DESC *pDesc,
  [in]            REFIID                riid,
  [out, optional] void                  **ppvHeap
);

매개 변수

[in] pDesc

형식: const D3D12_HEAP_DESC*

힙을 설명하는 상수 D3D12_HEAP_DESC 구조체에 대한 포인터입니다.

[in] riid

형식: REFIID

ppvHeap에서 반환할 힙 인터페이스의 GUID(Globally Unique Identifier)에 대한 참조입니다.

riidResource는 가장 일반적으로 ID3D12Heap의 GUID이지만 모든 인터페이스의 GUID일 수 있습니다. 리소스 개체가 이 GUID에 대한 인터페이스를 지원하지 않으면 E_NOINTERFACE 함께 생성이 실패합니다.

[out, optional] ppvHeap

형식: void**

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

ppvHeap 은 nullptr기능 테스트를 사용하도록 설정하는 일 수 있습니다. ppvHeap이 이면 nullptr개체가 만들어지지 않으며 pDesc가 유효하면 S_FALSE 반환됩니다.

반환 값

형식: HRESULT

함수가 성공하면 S_OK를 반환합니다. 그렇지 않으면 HRESULT오류 코드를 반환합니다.

반환 값	Description
E_OUTOFMEMORY	메모리가 부족하여 힙을 만들 수 없습니다.

가능한 다른 반환 값은 Direct3D 12 반환 코드를 참조하세요.

설명

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

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

배치된 리소스 개체는 생성된 힙에 대한 참조를 보유합니다. 그러나 예약된 리소스에는 힙에 대한 각 매핑에 대한 참조가 없습니다.

요구 사항

대상 플랫폼	Windows
헤더	d3d12.h
라이브러리	D3D12.lib
DLL	D3D12.dll

추가 정보

ID3D12Device

공유 힙