Sintaxe
Parâmetros
pDesc [in]Tipo: const D3D12_HEAP_DESC * Um ponteiro para uma estrutura constante D3D12_HEAP_DESC que descreve o heap. pProtectedSession [in, optional]
Tipo: ID3D12ProtectedResourceSession * Um ponteiro opcional para um objeto que representa uma sessão de proteção de conteúdo. Se fornecida, essa sessão indica que o heap deve ser protegido. Você pode obter uma ID3D12ProtectedResourceSession chamando ID3D12Device4::CreateProtectedResourceSession. Um heap com uma sessão protegida não pode ser criado com o sinalizador D3D12_HEAP_FLAG_SHARED_CROSS_ADAPTER. riid [in]
Tipo: const IID & Uma referência ao identificador global exclusivo (GUID) da interface de 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 heap criado. ppvHeap pode ser
nullptr para permitir o teste de capacidade. 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.
Consulte Códigos de retorno do Direct3D 12 para outros valores retornados possíveis.
Comentários
CreateHeap1 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 neste 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 para um heap.Requisitos
Cabeçalho: d3d12_xs.hBiblioteca: d3d12_xs.lib
Plataformas com suporte: consoles XBOX Series