> ## 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.

# AcpHalCreate

> AcpHalCreate

# AcpHalCreate

创建音频控制处理器(Audio Control Processor,ACP)接口的实例。

## 语法

```cpp theme={null}
HRESULT AcpHalCreate(  
         IAcpHal** acp  
)  
```

### 参数

*acp*   \_Outptr\_\
类型:IAcpHal\*\*

ACP 接口的实例。

### 返回值

类型:HRESULT

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

| 返回代码           | 描述      |
| -------------- | ------- |
| E\_OUTOFMEMORY | 内存分配失败。 |

## 备注

此调用会创建一个 ACP 客户端,一次只能处理一个流程图。如果需要同时处理多个流程图,请创建多个客户端。

在调用 [AcpHalCreate](/reference/audio/acphal/functions/acphalcreate) 之前,与 ACP 客户端配合使用的任何上下文都必须先通过 [AcpHalAllocateShapeContexts](/reference/audio/acphal/functions/acphalallocateshapecontexts) 分配。

## 要求

**头文件:** acphal.h

**库:** acphal.lib

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

## 另请参阅

[AcpHal](/reference/audio/acphal/acphal_members)


## Related topics

- [IAcpHal](/zh-CN/reference/audio/acphal/interfaces/IAcpHal/iacphal.md)
- [AcpHal](/zh-CN/reference/audio/acphal/acphal_members.md)
- [AcpHalAllocateShapeContexts](/zh-CN/reference/audio/acphal/functions/acphalallocateshapecontexts.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)