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

# AcpHal

> AcpHal

# AcpHal

## 介面

| 介面 | 描述 |
| - | - |
| [IAcpHal](/zh-TW/reference/audio/acphal/interfaces/IAcpHal/iacphal) | 允許與 ACP 互動。 |

## 函式

| 函式 | 描述 |
| - | - |
| [AcpHalAllocateShapeContexts](/zh-TW/reference/audio/acphal/functions/acphalallocateshapecontexts) | 配置 SHAPE 和 XMA 的內容陣列。 |
| [AcpHalCreate](/zh-TW/reference/audio/acphal/functions/acphalcreate) | 建立 ACP 介面的執行個體。 |
| [AcpHalReleaseShapeContexts](/zh-TW/reference/audio/acphal/functions/acphalreleaseshapecontexts) | 釋放 SHAPE 和 XMA 內容陣列。 |

## 結構

| 結構 | 描述 |
| - | - |
| [ACP\_COMMAND\_ENABLE\_OR\_DISABLE\_XMA\_CONTEXT](/zh-TW/reference/audio/acphal/structs/acp_command_enable_or_disable_xma_context) | 用於啟用或停用 XMA 內容的命令。 |
| [ACP\_COMMAND\_ENABLE\_OR\_DISABLE\_XMA\_CONTEXTS](/zh-TW/reference/audio/acphal/structs/acp_command_enable_or_disable_xma_contexts) | 用於啟用或停用一系列 XMA 內容的命令。 |
| [ACP\_COMMAND\_INCREMENT\_DMA\_POINTER](/zh-TW/reference/audio/acphal/structs/acp_command_increment_dma_pointer) | 用於更新 DMA 讀取或寫入指標的命令。 |
| [ACP\_COMMAND\_INCREMENT\_PCM\_WRITE\_POINTER](/zh-TW/reference/audio/acphal/structs/acp_command_increment_pcm_write_pointer) | 用於更新 PCM 寫入指標的命令。 |
| [ACP\_COMMAND\_INCREMENT\_XMA\_WRITE\_BUFFER\_OFFSET\_READ](/zh-TW/reference/audio/acphal/structs/acp_command_increment_xma_write_buffer_offset_read) | 遞增 SHAPE\_XMA\_CONTEXT 結構之輸出緩衝區的讀取位移。 |
| [ACP\_COMMAND\_LOAD\_SHAPE\_FLOWGRAPH](/zh-TW/reference/audio/acphal/structs/acp_command_load_shape_flowgraph) | 用於載入流程圖的命令。 |
| [ACP\_COMMAND\_MESSAGE](/zh-TW/reference/audio/acphal/structs/acp_command_message) | 註冊或取消註冊一或多個命令訊息。 |
| [ACP\_COMMAND\_UPDATE\_ALL\_CONTEXTS](/zh-TW/reference/audio/acphal/structs/acp_command_update_all_contexts) | 用於更新所有 SHAPE 內容類型之陣列的命令。 |
| [ACP\_COMMAND\_UPDATE\_CONTEXTS](/zh-TW/reference/audio/acphal/structs/acp_command_update_contexts) | 用於更新單一 SHAPE 內容類型之陣列的命令。 |
| [ACP\_COMMAND\_UPDATE\_DMA\_CONTEXT](/zh-TW/reference/audio/acphal/structs/acp_command_update_dma_context) | 用於更新 DMA 內容的命令。 |
| [ACP\_COMMAND\_UPDATE\_DMA\_READ\_CONTEXT\_ENTRY](/zh-TW/reference/audio/acphal/structs/acp_command_update_dma_read_context_entry) | 用於更新從混音緩衝區讀取之 SHAPE\_DMA\_CONTEXT 的項目。 |
| [ACP\_COMMAND\_UPDATE\_DMA\_WRITE\_CONTEXT\_ENTRY](/zh-TW/reference/audio/acphal/structs/acp_command_update_dma_write_context_entry) | 用於更新寫入混音緩衝區之 SHAPE\_DMA\_CONTEXT 的項目。 |
| [ACP\_COMMAND\_UPDATE\_EQCOMP\_CONTEXT](/zh-TW/reference/audio/acphal/structs/acp_command_update_eqcomp_context) | 用於更新 EQ/Comp 內容的命令。 |
| [ACP\_COMMAND\_UPDATE\_EQCOMP\_CONTEXT\_ENTRY](/zh-TW/reference/audio/acphal/structs/acp_command_update_eqcomp_context_entry) | 用於更新 SHAPE\_EQCOMP\_CONTEXT 的項目。 |
| [ACP\_COMMAND\_UPDATE\_FILTVOL\_CONTEXT](/zh-TW/reference/audio/acphal/structs/acp_command_update_filtvol_context) | 用於更新 Filter/Volume 內容的命令。 |
| [ACP\_COMMAND\_UPDATE\_FILTVOL\_CONTEXT\_ENTRY](/zh-TW/reference/audio/acphal/structs/acp_command_update_filtvol_context_entry) | 用於更新 SHAPE\_FILTVOL\_CONTEXT 的項目。 |
| [ACP\_COMMAND\_UPDATE\_PCM\_CONTEXT](/zh-TW/reference/audio/acphal/structs/acp_command_update_pcm_context) | 用於更新 PCM 內容的命令。 |
| [ACP\_COMMAND\_UPDATE\_PCM\_CONTEXT\_ENTRY](/zh-TW/reference/audio/acphal/structs/acp_command_update_pcm_context_entry) | 用於更新 SHAPE\_PCM\_CONTEXT 的項目。 |
| [ACP\_COMMAND\_UPDATE\_SRC\_CONTEXT](/zh-TW/reference/audio/acphal/structs/acp_command_update_src_context) | 用於更新 SRC 內容的命令。 |
| [ACP\_COMMAND\_UPDATE\_SRC\_CONTEXT\_ENTRY](/zh-TW/reference/audio/acphal/structs/acp_command_update_src_context_entry) | 用於更新 SHAPE\_SRC\_CONTEXT 的項目。 |
| [ACP\_COMMAND\_UPDATE\_XMA\_CONTEXT](/zh-TW/reference/audio/acphal/structs/acp_command_update_xma_context) | 用於更新 XMA 內容的命令。 |
| [ACP\_COMMAND\_UPDATE\_XMA\_CONTEXT\_ENTRY](/zh-TW/reference/audio/acphal/structs/acp_command_update_xma_context_entry) | 用於更新 SHAPE\_XMA\_CONTEXT 的項目。 |
| [ACP\_COMMAND\_UPDATE\_XMA\_READ\_BUFFER](/zh-TW/reference/audio/acphal/structs/acp_command_update_xma_read_buffer) | 更新 SHAPE\_XMA\_CONTEXT 中串流處理編碼資料所需的所有元素。 |
| [ACP\_MESSAGE](/zh-TW/reference/audio/acphal/structs/acp_message) | 來自 ACP 的訊息。 |
| [ACP\_MESSAGE\_AUDIO\_FRAME\_START](/zh-TW/reference/audio/acphal/structs/acp_message_audio_frame_start) | 音訊框架開始訊息。 |
| [ACP\_MESSAGE\_COMMAND\_COMPLETED](/zh-TW/reference/audio/acphal/structs/acp_message_command_completed) | ACP 命令已完成。 |
| [ACP\_MESSAGE\_ERROR](/zh-TW/reference/audio/acphal/structs/acp_message_error) | 來自 ACP 的錯誤訊息。 |
| [ACP\_MESSAGE\_FLOWGRAPH\_COMPLETED](/zh-TW/reference/audio/acphal/structs/acp_message_flowgraph_completed) | 流程圖已完成訊息。 |
| [ACP\_MESSAGE\_FLOWGRAPH\_TERMINATED](/zh-TW/reference/audio/acphal/structs/acp_message_flowgraph_terminated) | 流程圖已終止訊息。 |
| [ACP\_MESSAGE\_SHAPE\_COMMAND\_BLOCKED](/zh-TW/reference/audio/acphal/structs/acp_message_shape_command_blocked) | SHAPE 命令 (SRC 或 DMA) 內容遭到封鎖。 |
| [SHAPE\_CONTEXTS](/zh-TW/reference/audio/acphal/structs/shape_contexts) | SHAPE 內容資料。 |
| [SHARED\_SHAPE\_CONTEXTS](/zh-TW/reference/audio/acphal/structs/shared_shape_contexts) | 與 XAudio2 共用 SHAPE 和 XMA 資源時使用此結構。 |

## 列舉

| 列舉 | 描述 |
| - | - |
| [ACP\_COMMAND\_TYPE](/zh-TW/reference/audio/acphal/enums/acp_command_type) | 列舉 ACP 命令類型。 |
| [ACP\_FLOWGRAPH\_TERMINATED\_REASON](/zh-TW/reference/audio/acphal/enums/acp_flowgraph_terminated_reason) | 流程圖處理終止的原因。 |
| [ACP\_MESSAGE\_TYPE](/zh-TW/reference/audio/acphal/enums/acp_message_type) | 列舉 ACP 訊息類型。 |
| [ACP\_SUBMIT\_COMMAND\_TYPE](/zh-TW/reference/audio/acphal/enums/acp_submit_command_type) | 指出在傳回之前，是否要檢查要提交的命令及所有過去的命令都已完成。 |


## Related topics

- [AcpHal](/reference/audio/acphal/acphal_members.md)
- [AcpHalCreate](/reference/audio/acphal/functions/acphalcreate.md)
