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
最后修改于 2026年8月24日