Pular para o conteúdo principal
Cria um heap de diagnóstico para fins especiais na memória do sistema a partir de um objeto de mapeamento de arquivo. O heap criado pode persistir mesmo em um cenário de falha de GPU ou de remoção do dispositivo.

Sintaxe

Parâmetros

hFileMapping
Tipo: HANDLE
O identificador do objeto de mapeamento de arquivo a ser usado para criar o heap. riid
Tipo: const IID &
O identificador global exclusivo (GUID) da interface de heap (ID3D12Heap). O REFIID, ou GUID, da interface para o heap pode ser obtido usando a macro __uuidof(). Por exemplo, __uuidof(ID3D12Heap) recuperará o GUID da interface para um heap. ppvHeap [out]
Tipo: void **
SAL: COM_Outptr Um ponteiro para um bloco de memória. Em caso de êxito, o runtime do D3D12 gravará no bloco de memória um ponteiro para o heap recém-aberto. O tipo do ponteiro depende do parâmetro riid fornecido.

Valor retornado

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

Comentários

O heap é criado na memória do sistema e permite acesso da CPU. Ele encapsula toda a região de VirtualAlloc. Os heaps podem ser usados para recursos posicionados e reservados, de forma tão ortogonal quanto outros heaps. Ainda podem existir restrições com base nos sinalizadores que não podem ser escolhidos pelo aplicativo.

Requisitos

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

Confira também

Interface ID3D12Device3
Última modificação em 6 de outubro de 2026