Share via

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

  • Artigo

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

   
Cliente mínimo com suporte Windows 10 Build 20348
Servidor mínimo com suporte Windows 10 Build 20348
Plataforma de Destino Windows
Cabeçalho d3d12.h
Biblioteca D3d12.lib
DLL D3d12.dll

Confira também

Interface ID3D12Device3