Metodo ID3D12Device3::OpenExistingHeapFromAddress (d3d12.h)
Crea un heap diagnostico speciale in memoria di sistema da un indirizzo. L'heap creato può essere persistente anche in caso di errore GPU o di uno scenario rimosso dal dispositivo.
Sintassi
HRESULT OpenExistingHeapFromAddress(
[in] const void *pAddress,
REFIID riid,
[out] void **ppvHeap
);
Parametri
[in] pAddress
Tipo: const void*
Indirizzo usato 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
| Piattaforma di destinazione | Windows |
| Intestazione | d3d12.h |
| Libreria | D3d12.lib |
| DLL | D3d12.dll |