Metodo ID3D12Device3::OpenExistingHeapFromFileMapping (d3d12.h)

  • Articolo

Crea un heap diagnostico speciale in memoria di sistema da un oggetto di mapping di file. L'heap creato può essere persistente anche in caso di errore GPU o di uno scenario rimosso dal dispositivo.

Sintassi

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

Parametri

hFileMapping

Tipo: HANDLE

Handle per l'oggetto mapping di file da usare per creare l'heap.

riid

Tipo: REFIID

Identificatore univoco globale (GUID) per l'interfaccia heap (ID3D12Heap).

È possibile ottenere il GUID REFIID o il GUID dell'interfaccia nell'heap usando la macro __uuidof(). Ad esempio, __uuidof(ID3D12Heap) recupera il GUID dell'interfaccia in un heap.

[out] ppvHeap

Tipo: void**

SAL: COM_Outptr

Puntatore a un blocco di memoria. In caso di esito positivo, il runtime D3D12 scriverà un puntatore all'heap appena aperto nel blocco di memoria. Il tipo del puntatore dipende dal parametro riid specificato.

Valore restituito

Tipo: HRESULT

Questo metodo restituisce E_OUTOFMEMORY se è presente memoria insufficiente per aprire l'heap esistente. Per altri valori restituiti, vedere Codici restituiti Direct3D 12 .

Commenti

L'heap viene creato nella memoria di sistema e consente l'accesso alla CPU. Esegue il wrapping dell'intera area VirtualAlloc.

Gli heaps possono essere usati per le risorse posizionate e riservate, come in modo ortogonale come altri heaps. Le restrizioni possono comunque esistere in base ai flag che non possono essere scelti dall'app.

Requisiti

   
Client minimo supportato Windows 10 Build 20348
Server minimo supportato Windows 10 Build 20348
Piattaforma di destinazione Windows
Intestazione d3d12.h
Libreria D3d12.lib
DLL D3d12.dll

Vedi anche

Interfaccia ID3D12Device3