Metodo ID3D12Device3::OpenExistingHeapFromAddress (d3d12.h)

  • Articolo

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

Vedi anche

Interfaccia ID3D12Device3