다음을 통해 공유

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

  • 아티클

설명자 힙 개체를 만듭니다.

구문

HRESULT CreateDescriptorHeap(
  [in]  const D3D12_DESCRIPTOR_HEAP_DESC *pDescriptorHeapDesc,
        REFIID                           riid,
  [out] void                             **ppvHeap
);

매개 변수

[in] pDescriptorHeapDesc

형식: const D3D12_DESCRIPTOR_HEAP_DESC*

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

riid

형식: REFIID

설명자 힙 인터페이스에 대한 GUID(Globally Unique Identifier)입니다. 설명 부분을 참조하세요. 입력 매개 변수입니다.

[out] ppvHeap

형식: void**

설명자 힙에 대한 포인터를 수신하는 메모리 블록에 대한 포인터입니다. ppvHeap은 기능 테스트를 사용하도록 설정하기 위해 NULL일 수 있습니다. ppvHeap이 NULL이면 개체가 생성되지 않으며 pDescriptorHeapDesc가 유효하면 S_FALSE 반환됩니다.

반환 값

형식: HRESULT

이 메서드는 설명자 힙 개체를 만들기 위한 메모리가 부족한 경우 E_OUTOFMEMORY 반환합니다. 다른 가능한 반환 값은 Direct3D 12 반환 코드를 참조하세요.

설명

설명자 힙에 대한 인터페이스의 REFIID 또는 GUID는 __uuidof() 매크로를 사용하여 가져올 수 있습니다. 예를 들어 __uuidof(ID3D12DescriptorHeap)는 설명자 힙에 대한 인터페이스의 GUID 를 가져옵니다.

예제

D3D12HelloWorld 샘플은 다음과 같이 ID3D12Device::CreateDescriptorHeap을 사용합니다.

RTV(렌더링 대상 뷰) 설명자 힙을 설명하고 만듭니다.

// Create descriptor heaps.
{
    // Describe and create a render target view (RTV) descriptor heap.
    D3D12_DESCRIPTOR_HEAP_DESC rtvHeapDesc = {};
    rtvHeapDesc.NumDescriptors = FrameCount;
    rtvHeapDesc.Type = D3D12_DESCRIPTOR_HEAP_TYPE_RTV;
    rtvHeapDesc.Flags = D3D12_DESCRIPTOR_HEAP_FLAG_NONE;
    ThrowIfFailed(m_device->CreateDescriptorHeap(&rtvHeapDesc, IID_PPV_ARGS(&m_rtvHeap)));

    m_rtvDescriptorSize = m_device->GetDescriptorHandleIncrementSize(D3D12_DESCRIPTOR_HEAP_TYPE_RTV);
}

// Create frame resources.
{
    CD3DX12_CPU_DESCRIPTOR_HANDLE rtvHandle(m_rtvHeap->GetCPUDescriptorHandleForHeapStart());

    // Create a RTV for each frame.
    for (UINT n = 0; n < FrameCount; n++)
    {
        ThrowIfFailed(m_swapChain->GetBuffer(n, IID_PPV_ARGS(&m_renderTargets[n])));
        m_device->CreateRenderTargetView(m_renderTargets[n].Get(), nullptr, rtvHandle);
        rtvHandle.Offset(1, m_rtvDescriptorSize);
    }

D3D12 참조의 예제 코드를 참조하세요.

요구 사항

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

추가 정보

ID3D12Device