ID3D12Device3：：OpenExistingHeapFromFileMapping 方法 (d3d12.h)

從檔案對應物件，在系統記憶體中建立特殊用途診斷堆積。即使發生 GPU 錯誤或裝置移除的案例，建立的堆積仍可保存。

語法

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

hFileMapping

類型： HANDLE

用來建立堆積之檔案對應物件的控制碼。

riid

類型： REFIID

堆積介面的全域唯一識別碼 (GUID) ， (ID3D12Heap) 。

您可以使用__uuidof () 宏來取得堆積介面的REFIID或GUID。例如， __uuidof (ID3D12Heap) 會擷取堆積介面的 GUID 。

[out] ppvHeap

類型： void**

SAL： COM_Outptr

記憶體區塊的指標。成功時，D3D12 執行時間會將新開啟堆積的指標寫入記憶體區塊。指標的類型取決於提供的 riid 參數。

類型： HRESULT

如果記憶體不足而無法開啟現有的堆積，這個方法會傳回 E_OUTOFMEMORY 。如需其他可能的傳回值，請參閱 Direct3D 12 傳回碼。

堆積會在系統記憶體中建立，並允許 CPU 存取。它會包裝整個 VirtualAlloc 區域。

堆積可用於放置和保留的資源，就像其他堆積一樣正交。限制可能仍會根據無法選擇應用程式的旗標存在。