Método ID3D12Device::CreateDescriptorHeap (d3d12.h)

Crea un objeto de montón de descriptores.

Sintaxis

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

Parámetros

[in] pDescriptorHeapDesc

Tipo: const D3D12_DESCRIPTOR_HEAP_DESC*

Puntero a una estructura D3D12_DESCRIPTOR_HEAP_DESC que describe el montón.

riid

Tipo: REFIID

Identificador único global (GUID) de la interfaz del montón del descriptor. Vea la sección Comentarios. Parámetro de entrada.

[out] ppvHeap

Tipo: void**

Puntero a un bloque de memoria que recibe un puntero al montón del descriptor. ppvHeap puede ser NULL para habilitar las pruebas de funcionalidad. Cuando ppvHeap es NULL, no se creará ningún objeto y S_FALSE se devolverá cuando pDescriptorHeapDesc sea válido.

Valor devuelto

Tipo: HRESULT

Este método devuelve E_OUTOFMEMORY si no hay memoria suficiente para crear el objeto del montón del descriptor. Consulta Códigos de retorno de Direct3D 12 para ver otros valores devueltos posibles.

Comentarios

El REFIID, o GUID, de la interfaz al montón de descriptores se puede obtener mediante la macro __uuidof(). Por ejemplo, __uuidof(ID3D12DescriptorHeap) obtendrá el GUID de la interfaz en un montón de descriptores.

Ejemplos

El ejemplo D3D12HelloWorld usa ID3D12Device::CreateDescriptorHeap como se indica a continuación:

Describir y crear un montón de descriptores de vista de destino de representación (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);
    }

Consulte el código de ejemplo en la referencia de D3D12.

Requisitos

Plataforma de destino	Windows
Encabezado	d3d12.h
Library	D3D12.lib
Archivo DLL	D3D12.dll

Consulte también

ID3D12Device