Metodo ID3D12Device3::OpenExistingHeapFromFileMapping (d3d12.h)
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 |