Sintaxe
Parâmetros
pDesc [in]Tipo: const D3D12_HEAP_DESC * Um ponteiro para uma estrutura constante D3D12_HEAP_DESC que descreve o heap. riid [in]
Tipo: const IID & Uma referência ao identificador global exclusivo (GUID) da interface do heap a ser retornada em ppvHeap. Embora riidResource seja mais comumente o GUID de ID3D12Heap, ele pode ser o GUID de qualquer interface. Se o objeto de recurso não der suporte à interface desse GUID, a criação falhará com E_NOINTERFACE. ppvHeap [out, optional]
Tipo: void ** Um ponteiro opcional para um bloco de memória que recebe o ponteiro de interface solicitado para o objeto de heap criado. ppvHeap pode ser
nullptr, para permitir o teste de funcionalidades. Quando ppvHeap é nullptr, nenhum objeto é criado e S_FALSE é retornado quando pDesc é válido.
Valor retornado
Tipo: HRESULT Se a função for bem-sucedida, ela retornará S_OK. Caso contrário, retornará um código de erro HRESULT.
Confira Códigos de retorno do Direct3D 12 para outros valores de retorno possíveis.
Comentários
CreateHeap cria um heap que pode ser usado com recursos posicionados e recursos reservados. Antes de liberar a referência final ao heap, seu aplicativo deve garantir que a GPU não lerá nem gravará mais nesse heap. Um objeto de recurso posicionado mantém uma referência ao heap no qual foi criado; mas um recurso reservado não mantém uma referência para cada mapeamento feito em um heap.Requisitos
Cabeçalho: d3d12_xs.h ou d3d12_x.hBiblioteca: d3d12_xs.lib ou d3d12_x.lib
Plataformas com suporte: consoles XBOX Series e família XBOX One