> ## 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](/reference/audio/acphal/interfaces/IAcpHal/iacphal) | ACP와의 상호 작용을 허용합니다. |

## 함수

| 함수                                                                                           | 설명                           |
| -------------------------------------------------------------------------------------------- | ---------------------------- |
| [AcpHalAllocateShapeContexts](/reference/audio/acphal/functions/acphalallocateshapecontexts) | SHAPE 및 XMA용 컨텍스트 배열을 할당합니다. |
| [AcpHalCreate](/reference/audio/acphal/functions/acphalcreate)                               | ACP 인터페이스의 인스턴스를 만듭니다.       |
| [AcpHalReleaseShapeContexts](/reference/audio/acphal/functions/acphalreleaseshapecontexts)   | SHAPE 및 XMA 컨텍스트 배열을 해제합니다.  |

## 구조체

| 구조체                                                                                                                                             | 설명                                                          |
| ----------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- |
| [ACP\_COMMAND\_ENABLE\_OR\_DISABLE\_XMA\_CONTEXT](/reference/audio/acphal/structs/acp_command_enable_or_disable_xma_context)                    | XMA 컨텍스트를 활성화 또는 비활성화하기 위한 명령입니다.                           |
| [ACP\_COMMAND\_ENABLE\_OR\_DISABLE\_XMA\_CONTEXTS](/reference/audio/acphal/structs/acp_command_enable_or_disable_xma_contexts)                  | 일련의 XMA 컨텍스트를 활성화 또는 비활성화하기 위한 명령입니다.                       |
| [ACP\_COMMAND\_INCREMENT\_DMA\_POINTER](/reference/audio/acphal/structs/acp_command_increment_dma_pointer)                                      | DMA 읽기 또는 쓰기 포인터를 업데이트하기 위한 명령입니다.                          |
| [ACP\_COMMAND\_INCREMENT\_PCM\_WRITE\_POINTER](/reference/audio/acphal/structs/acp_command_increment_pcm_write_pointer)                         | PCM 쓰기 포인터를 업데이트하기 위한 명령입니다.                                |
| [ACP\_COMMAND\_INCREMENT\_XMA\_WRITE\_BUFFER\_OFFSET\_READ](/reference/audio/acphal/structs/acp_command_increment_xma_write_buffer_offset_read) | SHAPE\_XMA\_CONTEXT 구조체 출력 버퍼의 읽기 오프셋을 증가시킵니다.              |
| [ACP\_COMMAND\_LOAD\_SHAPE\_FLOWGRAPH](/reference/audio/acphal/structs/acp_command_load_shape_flowgraph)                                        | 플로우그래프를 로드하기 위한 명령입니다.                                      |
| [ACP\_COMMAND\_MESSAGE](/reference/audio/acphal/structs/acp_command_message)                                                                    | 하나 이상의 명령 메시지를 등록하거나 등록 해제합니다.                              |
| [ACP\_COMMAND\_UPDATE\_ALL\_CONTEXTS](/reference/audio/acphal/structs/acp_command_update_all_contexts)                                          | 모든 SHAPE 컨텍스트 유형의 배열을 업데이트하기 위한 명령입니다.                      |
| [ACP\_COMMAND\_UPDATE\_CONTEXTS](/reference/audio/acphal/structs/acp_command_update_contexts)                                                   | 단일 SHAPE 컨텍스트 유형의 배열을 업데이트하기 위한 명령입니다.                      |
| [ACP\_COMMAND\_UPDATE\_DMA\_CONTEXT](/reference/audio/acphal/structs/acp_command_update_dma_context)                                            | DMA 컨텍스트를 업데이트하기 위한 명령입니다.                                  |
| [ACP\_COMMAND\_UPDATE\_DMA\_READ\_CONTEXT\_ENTRY](/reference/audio/acphal/structs/acp_command_update_dma_read_context_entry)                    | 믹스 버퍼에서 읽는 SHAPE\_DMA\_CONTEXT를 업데이트하기 위한 항목입니다.            |
| [ACP\_COMMAND\_UPDATE\_DMA\_WRITE\_CONTEXT\_ENTRY](/reference/audio/acphal/structs/acp_command_update_dma_write_context_entry)                  | 믹스 버퍼에 쓰는 SHAPE\_DMA\_CONTEXT를 업데이트하기 위한 항목입니다.             |
| [ACP\_COMMAND\_UPDATE\_EQCOMP\_CONTEXT](/reference/audio/acphal/structs/acp_command_update_eqcomp_context)                                      | EQ/Comp 컨텍스트를 업데이트하기 위한 명령입니다.                              |
| [ACP\_COMMAND\_UPDATE\_EQCOMP\_CONTEXT\_ENTRY](/reference/audio/acphal/structs/acp_command_update_eqcomp_context_entry)                         | SHAPE\_EQCOMP\_CONTEXT를 업데이트하기 위한 항목입니다.                    |
| [ACP\_COMMAND\_UPDATE\_FILTVOL\_CONTEXT](/reference/audio/acphal/structs/acp_command_update_filtvol_context)                                    | Filter/Volume 컨텍스트를 업데이트하기 위한 명령입니다.                        |
| [ACP\_COMMAND\_UPDATE\_FILTVOL\_CONTEXT\_ENTRY](/reference/audio/acphal/structs/acp_command_update_filtvol_context_entry)                       | SHAPE\_FILTVOL\_CONTEXT를 업데이트하기 위한 항목입니다.                   |
| [ACP\_COMMAND\_UPDATE\_PCM\_CONTEXT](/reference/audio/acphal/structs/acp_command_update_pcm_context)                                            | PCM 컨텍스트를 업데이트하기 위한 명령입니다.                                  |
| [ACP\_COMMAND\_UPDATE\_PCM\_CONTEXT\_ENTRY](/reference/audio/acphal/structs/acp_command_update_pcm_context_entry)                               | SHAPE\_PCM\_CONTEXT를 업데이트하기 위한 항목입니다.                       |
| [ACP\_COMMAND\_UPDATE\_SRC\_CONTEXT](/reference/audio/acphal/structs/acp_command_update_src_context)                                            | SRC 컨텍스트를 업데이트하기 위한 명령입니다.                                  |
| [ACP\_COMMAND\_UPDATE\_SRC\_CONTEXT\_ENTRY](/reference/audio/acphal/structs/acp_command_update_src_context_entry)                               | SHAPE\_SRC\_CONTEXT를 업데이트하기 위한 항목입니다.                       |
| [ACP\_COMMAND\_UPDATE\_XMA\_CONTEXT](/reference/audio/acphal/structs/acp_command_update_xma_context)                                            | XMA 컨텍스트를 업데이트하기 위한 명령입니다.                                  |
| [ACP\_COMMAND\_UPDATE\_XMA\_CONTEXT\_ENTRY](/reference/audio/acphal/structs/acp_command_update_xma_context_entry)                               | SHAPE\_XMA\_CONTEXT를 업데이트하기 위한 항목입니다.                       |
| [ACP\_COMMAND\_UPDATE\_XMA\_READ\_BUFFER](/reference/audio/acphal/structs/acp_command_update_xma_read_buffer)                                   | 인코딩된 데이터를 스트리밍하는 데 필요한 SHAPE\_XMA\_CONTEXT의 모든 요소를 업데이트합니다. |
| [ACP\_MESSAGE](/reference/audio/acphal/structs/acp_message)                                                                                     | ACP로부터의 메시지입니다.                                             |
| [ACP\_MESSAGE\_AUDIO\_FRAME\_START](/reference/audio/acphal/structs/acp_message_audio_frame_start)                                              | 오디오 프레임 시작 메시지입니다.                                          |
| [ACP\_MESSAGE\_COMMAND\_COMPLETED](/reference/audio/acphal/structs/acp_message_command_completed)                                               | ACP 명령이 완료되었습니다.                                            |
| [ACP\_MESSAGE\_ERROR](/reference/audio/acphal/structs/acp_message_error)                                                                        | ACP로부터의 오류 메시지입니다.                                          |
| [ACP\_MESSAGE\_FLOWGRAPH\_COMPLETED](/reference/audio/acphal/structs/acp_message_flowgraph_completed)                                           | 플로우그래프 완료 메시지입니다.                                           |
| [ACP\_MESSAGE\_FLOWGRAPH\_TERMINATED](/reference/audio/acphal/structs/acp_message_flowgraph_terminated)                                         | 플로우그래프 종료 메시지입니다.                                           |
| [ACP\_MESSAGE\_SHAPE\_COMMAND\_BLOCKED](/reference/audio/acphal/structs/acp_message_shape_command_blocked)                                      | SHAPE 명령(SRC 또는 DMA) 컨텍스트가 차단되었습니다.                         |
| [SHAPE\_CONTEXTS](/reference/audio/acphal/structs/shape_contexts)                                                                               | SHAPE 컨텍스트 데이터입니다.                                          |
| [SHARED\_SHAPE\_CONTEXTS](/reference/audio/acphal/structs/shared_shape_contexts)                                                                | 이 구조체는 SHAPE 및 XMA 리소스를 XAudio2와 공유할 때 사용됩니다.               |

## 열거형

| 열거형                                                                                                 | 설명                                               |
| --------------------------------------------------------------------------------------------------- | ------------------------------------------------ |
| [ACP\_COMMAND\_TYPE](/reference/audio/acphal/enums/acp_command_type)                                | ACP 명령 유형을 열거합니다.                                |
| [ACP\_FLOWGRAPH\_TERMINATED\_REASON](/reference/audio/acphal/enums/acp_flowgraph_terminated_reason) | 플로우그래프 처리가 종료된 이유입니다.                            |
| [ACP\_MESSAGE\_TYPE](/reference/audio/acphal/enums/acp_message_type)                                | ACP 메시지 유형을 열거합니다.                               |
| [ACP\_SUBMIT\_COMMAND\_TYPE](/reference/audio/acphal/enums/acp_submit_command_type)                 | 제출할 명령과 모든 이전 명령이 반환되기 전에 완료되었는지 확인할지 여부를 나타냅니다. |


## Related topics

- [AcpHalCreate](/ko/reference/audio/acphal/functions/acphalcreate.md)
- [IAcpHal::Connect](/ko/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_connect.md)
- [IAcpHal::Disconnect](/ko/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_disconnect.md)
- [AcpHalAllocateShapeContexts](/ko/reference/audio/acphal/functions/acphalallocateshapecontexts.md)
- [AcpHalReleaseShapeContexts](/ko/reference/audio/acphal/functions/acphalreleaseshapecontexts.md)
