Pular para o conteúdo principal
Cria um objeto heap de descritores.

Sintaxe

Parâmetros

pDescriptorHeapDesc [in]
Tipo: const D3D12_DESCRIPTOR_HEAP_DESC *
Um ponteiro para uma estrutura D3D12_DESCRIPTOR_HEAP_DESC que descreve o heap. riid
Tipo: const IID &
O identificador global exclusivo (GUID) da interface do heap de descritores. Consulte Comentários. Um parâmetro de entrada. ppvHeap [out]
Tipo: void **
Um ponteiro para um bloco de memória que recebe um ponteiro para o heap de descritores. ppvHeap pode ser NULL, para permitir testes de funcionalidade. Quando ppvHeap é NULL, nenhum objeto é criado e S_FALSE é retornado quando pDescriptorHeapDesc é válido.

Valor retornado

Tipo: HRESULT Este método retornará E_OUTOFMEMORY se não houver memória suficiente para criar o objeto heap de descritores. Consulte Códigos de retorno do Direct3D 12 para outros valores retornados possíveis.

Comentários

O REFIID, ou GUID, da interface do heap de descritores pode ser obtido usando a macro __uuidof(). Por exemplo, __uuidof(ID3D12DescriptorHeap) obterá o GUID da interface de um heap de descritores.

Exemplos

O exemplo D3D12HelloWorld usa ID3D12Device::CreateDescriptorHeap da seguinte maneira: Descreva e crie um heap de descritores de exibição de destino de renderização (RTV).
Consulte o Código de exemplo na referência do D3D12.

Requisitos

Cabeçalho: d3d12_xs.h ou d3d12_x.h
Biblioteca: d3d12_xs.lib ou d3d12_x.lib
Plataformas compatíveis: consoles XBOX Series e família XBOX One

Confira também

ID3D12Device
Última modificação em 6 de outubro de 2026