Skip to main content

AcpHalAllocateShapeContexts

为可伸缩硬件音频处理引擎(Scalable Hardware Audio Processing Engine,SHAPE)和 XBOX Media Audio(XMA)分配上下文数组。

语法

参数

contextArrays   _Inout_
类型:SHAPE_CONTEXTS*
传入时,该上下文应包含所请求的上下文数组大小。如果函数成功,该上下文将被填充为已分配的数组。请参阅 SHAPE_DMA_CONTEXTSHAPE_EQCOMP_CONTEXTSHAPE_FILTVOL_CONTEXTSHAPE_PCM_CONTEXTSHAPE_SRC_CONTEXTSHAPE_XMA_CONTEXT 结构体。

返回值

类型:HRESULT 如果方法成功,则返回 S_OK。如果方法失败,则返回以下代码之一(部分列表):

备注

在调用 AcpHalCreate 之前,调用此方法为音频控制处理器(Audio Control Processor,ACP)客户端分配上下文。 除非之后调用了 AcpHalReleaseShapeContexts,否则此方法只应调用一次。 采样率转换器(Sample Rate Convertor,SRC)上下文的数量必须等于脉冲编码调制(PCM)上下文数量与 XMA 上下文数量之和。

要求

头文件: acphal.h 库: acphal.lib 支持的平台: XBOX One 系列主机和 XBOX Series 主机

另请参阅

AcpHalReleaseShapeContexts
AcpHalCreate
AcpHal
最后修改于 2026年8月24日