跳轉到主要內容
從位址在系統記憶體中建立特殊用途的診斷堆積。即使在 GPU 錯誤或裝置移除的情況下,所建立的堆積仍可持續存在。

語法

參數

pAddress [in]
類型:const void *
用來建立堆積的位址。 riid
類型:const IID &
堆積介面 (ID3D12Heap) 的全域唯一識別碼 (GUID)。 堆積介面的 REFIID (或 GUID) 可以使用 __uuidof() 巨集取得。例如,__uuidof(ID3D12Heap) 會擷取堆積介面的 GUID。 ppvHeap [out]
類型:void **
SAL:COM_Outptr 記憶體區塊的指標。成功時,D3D12 執行階段會將新開啟之堆積的指標寫入記憶體區塊。指標的類型取決於提供的 riid 參數。

傳回值

類型:HRESULT 如果記憶體不足而無法開啟現有的堆積,此方法會傳回 E_OUTOFMEMORY。如需其他可能的傳回值,請參閱 Direct3D 12 傳回碼。

備註

堆積會在系統記憶體中建立,並允許 CPU 存取。它會包裝整個 VirtualAlloc 區域。 堆積可以用於放置的資源和保留的資源,與其他堆積一樣具有正交性。根據無法由應用程式選擇的旗標,可能仍會存在限制。

需求

標頭: d3d12_xs.h 或 d3d12_x.h
程式庫: d3d12_xs.lib 或 d3d12_x.lib
支援的平台:XBOX Series 主機與 XBOX One 系列

另請參閱

ID3D12Device3 介面
最後修改於 2026年10月6日