> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AcpHalReleaseShapeContexts

> AcpHalReleaseShapeContexts

# AcpHalReleaseShapeContexts

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

## 语法

```cpp theme={null}
HRESULT AcpHalReleaseShapeContexts(  
)  
```

### 参数

无。

### 返回值

类型:HRESULT

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

| 返回代码                   | 描述         |
| ---------------------- | ---------- |
| ACP\_E\_NOT\_ALLOCATED | 上下文数组尚未分配。 |

## 备注

调用此方法以释放通过调用 [AcpHalAllocateShapeContexts](/reference/audio/acphal/functions/acphalallocateshapecontexts) 创建的音频控制处理器(Audio Control Processor,ACP)上下文。

所有 ACP 和 SHAPE 资源(尤其是上下文数组)由所有客户端共享。这些客户端必须协调这些资源的分配和共享。

## 要求

**头文件:** acphal.h

**库:** acphal.lib

**支持的平台:** XBOX One 系列主机和 XBOX Series 主机

## 另请参阅

[AcpHalAllocateShapeContexts](/reference/audio/acphal/functions/acphalallocateshapecontexts)\
[AcpHal](/reference/audio/acphal/acphal_members)


## Related topics

- [AcpHalAllocateShapeContexts](/zh-CN/reference/audio/acphal/functions/acphalallocateshapecontexts.md)
- [AcpHal](/zh-CN/reference/audio/acphal/acphal_members.md)
- [IAcpHal::Connect](/zh-CN/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_connect.md)
- [ACP_MESSAGE_ERROR](/zh-CN/reference/audio/acphal/structs/acp_message_error.md)
- [SHAPE_CONTEXTS](/zh-CN/reference/audio/acphal/structs/shape_contexts.md)