ID3D12Device4::CreateHeap1 메서드(d3d12.h)
배치된 리소스 및 예약된 리소스와 함께 사용할 수 있는 힙(선택적으로 보호된 세션의 경우)을 만듭니다. 또한 ID3D12Device::CreateHeap참조하세요.
통사론
HRESULT CreateHeap1(
[in] const D3D12_HEAP_DESC *pDesc,
[in, optional] ID3D12ProtectedResourceSession *pProtectedSession,
[in] REFIID riid,
[out, optional] void **ppvHeap
);
매개 변수
[in] pDesc
형식: const D3D12_HEAP_DESC*
힙을 설명하는 상수 D3D12_HEAP_DESC 구조체에 대한 포인터입니다.
[in, optional] pProtectedSession
형식: ID3D12ProtectedResourceSession*
콘텐츠 보호를 위한 세션을 나타내는 개체에 대한 선택적 포인터입니다. 제공된 경우 이 세션은 힙을 보호해야 임을 나타냅니다. ID3D12Device4::CreateProtectedResourceSession호출하여 ID3D12ProtectedResourceSession 가져올 수 있습니다.
보호된 세션이 있는 힙은 D3D12_HEAP_FLAG_SHARED_CROSS_ADAPTER 플래그를 사용하여 만들 수 없습니다.
[in] riid
형식: REFIID
ppvHeap반환할 힙 인터페이스의 전역 고유 식별자(GUID)에 대한 참조입니다.
riidResource 가장 일반적으로 ID3D12HeapGUID 있지만 모든 인터페이스의 GUID 수 있습니다. 리소스 개체가 이 GUID대한 인터페이스를 지원하지 않으면 E_NOINTERFACE생성에 실패합니다.
[out, optional] ppvHeap
형식: void**
생성된 힙 개체에 대한 요청된 인터페이스 포인터를 수신하는 메모리 블록에 대한 선택적 포인터입니다.
ppvHeapnullptr기능 테스트를 사용하도록 설정할 수 있습니다.
반환 값
형식: HRESULT
함수가 성공하면 S_OK반환합니다. 그렇지 않으면 HRESULT오류 코드반환합니다.
| 반환 값 | 묘사 |
|---|---|
| E_OUTOFMEMORY | 힙을 만들 메모리가 부족합니다. |
다른 가능한 반환 값은 Direct3D 12 반환 코드 참조하세요.
발언
CreateHeap1 배치된 리소스 및 예약된 리소스와 함께 사용할 수 있는 힙을 만듭니다.
힙에서 최종 참조를 해제하기 전에 애플리케이션은 GPU가 더 이상 이 힙을 읽거나 쓰지 않도록 해야 합니다.
배치된 리소스 개체는 만들어진 힙에 대한 참조를 보유합니다. 그러나 예약된 리소스는 힙에 대한 각 매핑에 대한 참조를 보유하지 않습니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10 빌드 20348 |
| 지원되는 최소 서버 | Windows 10 빌드 20348 |
| 대상 플랫폼 | Windows |
| 헤더 | d3d12.h |
| 라이브러리 | d3d12.lib |
| DLL | d3d12.dll |