Método ID3D12Device3::OpenExistingHeapFromFileMapping (d3d12.h)

Cria um heap de diagnóstico de finalidade especial na memória do sistema a partir de um objeto de mapeamento de arquivo. O heap criado pode persistir mesmo no caso de um cenário de falha de GPU ou de dispositivo removido.

Sintaxe

HRESULT OpenExistingHeapFromFileMapping(
        HANDLE hFileMapping,
        REFIID riid,
  [out] void   **ppvHeap
);

Parâmetros

hFileMapping

Tipo: HANDLE

O identificador para o objeto de mapeamento de arquivo a ser usado para criar o heap.

riid

Tipo: REFIID

O GUID (identificador global exclusivo) para a 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.

[out] ppvHeap

Tipo: void**

SAL: COM_Outptr

Um ponteiro para um bloco de memória. Em caso de êxito, o runtime D3D12 gravará um ponteiro para o heap recém-aberto no bloco de memória. O tipo do ponteiro depende do parâmetro riid fornecido.

Valor retornado

Tipo: HRESULT

Esse método retornará E_OUTOFMEMORY se não houver memória suficiente para abrir o heap existente. Consulte Códigos de retorno do Direct3D 12 para obter outros valores retornados possíveis.

Comentários

O heap é criado na memória do sistema e permite o acesso à CPU. Ele encapsula toda a região VirtualAlloc.

Heaps podem ser usados para recursos colocados e reservados, como ortogonalmente como outros heaps. As restrições ainda podem existir com base nos sinalizadores que não podem ser escolhidos pelo aplicativo.

Requisitos

Confira também

Interface ID3D12Device3