Skip to main content

ApuCreateHeap

建立 APU 堆積。

語法

參數

cachedSizeInBytes   _In_
類型:UINT32
快取記憶體配置的大小 (以位元組為單位)。 nonCachedSizeInBytes   _In_opt_
類型:UINT32
非快取配置的大小 (以位元組為單位)。如果為 0,則使用約 1 MB 的預設配置。

傳回值

類型:HRESULT 除了其他錯誤碼之外,此方法還可能會傳回下列值:

備註

只能建立單一 APU 堆積;它會在處理序的整個存留期間持續存在。只有在處理序終止時才會釋放堆積。 為了確保依照您的特定需求配置堆積,請在任何其他 ACP HAL 和 APU 方法之前呼叫此方法。 如果在此方法之前呼叫了任何 ACP HAL (AcpHal.h) 或 APU 方法,系統會配置 64 MB 的快取堆積和約 1 MB 的非快取堆積;之後對此方法的呼叫會失敗並傳回 APU_E_HEAP_ALREADY_ALLOCATED。 快取記憶體用於所有 Waves 資產以及命令和訊息佇列。非快取記憶體用於 SHAPE 內容和通知。

需求

標頭: apu.h 程式庫: acphal.lib 支援的平台: XBOX One 系列主機和 XBOX Series 主機

概念文件

另請參閱

APU
Last modified on October 6, 2026