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

建立音訊控制處理器 (ACP) 介面的執行個體。

## 語法

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

### 參數

*acp*   \_Outptr\_\
類型：IAcpHal\*\*

ACP 介面的執行個體。

### 傳回值

類型：HRESULT

如果方法成功，會傳回 `S_OK`。如果方法失敗，會傳回下列其中一個代碼 (部分清單)：

| 傳回碼 | 描述 |
| - | - |
| E\_OUTOFMEMORY | 記憶體配置失敗。 |

## 備註

此呼叫會建立 ACP 用戶端，一次可以處理一個流程圖。如果要同時處理多個流程圖，請建立多個用戶端。

要與 ACP 用戶端搭配使用的任何內容，都必須在呼叫 [AcpHalCreate](/zh-TW/reference/audio/acphal/functions/acphalcreate) 之前，使用 [AcpHalAllocateShapeContexts](/zh-TW/reference/audio/acphal/functions/acphalallocateshapecontexts) 配置。

## 需求

**標頭：** acphal.h

**程式庫：** acphal.lib

**支援的平台：** XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[AcpHal](/zh-TW/reference/audio/acphal/acphal_members)


## Related topics

- [AcpHalCreate](/reference/audio/acphal/functions/acphalcreate.md)
- [IAcpHal](/reference/audio/acphal/interfaces/IAcpHal/iacphal.md)
- [AcpHal](/reference/audio/acphal/acphal_members.md)
- [AcpHalAllocateShapeContexts](/reference/audio/acphal/functions/acphalallocateshapecontexts.md)