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

# ACP_MESSAGE_ERROR

> ACP_MESSAGE_ERROR

# ACP\_MESSAGE\_ERROR

ACP에서 온 오류 메시지입니다.

## Syntax

```cpp theme={null}
typedef struct ACP_MESSAGE_ERROR {  
    HRESULT errorCode; 
    UINT32 additionalData;  
} ACP_MESSAGE_ERROR  
```

### Members

*errorCode*\
Type: HRESULT

오류 코드입니다.

*additionalData*\
Type: UINT32

오류와 관련된 추가 데이터입니다.

## Remarks

*errorCode*로 반환되는 값의 의미는 다음과 같습니다.

| *errorCode*                          | 설명                                                                                                   |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------- |
| ACP\_E\_ALREADY\_ALLOCATED           | 데이터가 이미 할당되어 있습니다.                                                                                   |
| ACP\_E\_ALREADY\_CONNECTED           | 인스턴스가 이미 ACP에 연결되어 있습니다.                                                                             |
| ACP\_E\_ALREADY\_REGISTERED          | 이미 등록되어 있습니다.                                                                                        |
| ACP\_E\_INVALID\_COMMAND             | 명령이 유효하지 않습니다. *additionalData*에 `commandId`가 포함되어 있습니다.                                             |
| ACP\_E\_INVALID\_COMMAND\_TYPE       | 명령 유형이 유효하지 않습니다. ([ACP\_COMMAND\_TYPE](/reference/audio/acphal/enums/acp_command_type) 열거형을 참조하세요.) |
| ACP\_E\_INVALID\_CONTEXT\_DATA       | 컨텍스트 데이터가 유효하지 않습니다.                                                                                 |
| ACP\_E\_INVALID\_FLOWGRAPH           | 지정된 플로우그래프가 유효하지 않습니다. 플로우그래프 엔트리 헤더를 검사하세요. 유효하지 않은 엔트리에는 오류 비트가 설정되어 있습니다.                         |
| ACP\_E\_INVALID\_MESSAGE\_TYPE       | 메시지 유형이 유효하지 않습니다.                                                                                   |
| ACP\_E\_INVALID\_XMA\_CONTEXT        | XMA 컨텍스트의 인덱스가 유효하지 않습니다.                                                                            |
| ACP\_E\_MESSAGE\_ALREADY\_REGISTERED | 메시지 유형이 이미 등록되어 있어 등록할 수 없습니다.                                                                       |
| ACP\_E\_MESSAGE\_NOT\_REGISTERED     | 메시지 유형이 등록되어 있지 않아 등록 해제할 수 없습니다.                                                                    |
| ACP\_E\_NOT\_ALLOCATED               | 데이터가 할당되지 않았습니다.                                                                                     |
| ACP\_E\_NOT\_CONNECTED               | 인스턴스가 ACP에 연결되어 있지 않습니다.                                                                             |
| ACP\_E\_NOT\_REGISTERED              | 등록되어 있지 않습니다.                                                                                        |
| ACP\_E\_QUEUE\_FULL                  | 명령 큐가 가득 찼습니다.                                                                                       |
| ACP\_E\_STILL\_CONNECTED             | ACP에 연결된 상태에서는 시도한 작업을 수행할 수 없습니다.                                                                   |
| ACP\_E\_XMA\_PARSER\_ERROR           | XMA 컨텍스트에서 파서 오류가 발생했습니다. *additionalData*에 XMA 컨텍스트의 인덱스가 포함되어 있습니다.                                |
| ACP\_E\_CORE\_UNHANDLED\_EXCEPTION   | 코어에서 처리되지 않은 예외가 발생하여 이제 충돌/멈춤 상태입니다.                                                                |

이 구조체는 `ACP_MESSAGE_TYPE_ERROR` 메시지에서 사용됩니다. 이 구조체는 [ACP\_MESSAGE\_TYPE](/reference/audio/acphal/enums/acp_message_type) 구조체에서도 사용됩니다.

`ACP_E_CORE_UNHANDLED_EXCEPTION` 코드를 수신한 경우, **모든** 기존 ACP 클라이언트 객체를 파괴하고 [AcpHalReleaseShapeContexts](/reference/audio/acphal/functions/acphalreleaseshapecontexts)를 사용하여 할당된 SHAPE 컨텍스트를 해제하는 것이 좋습니다. 새로운 SHAPE 컨텍스트 및 ACP 클라이언트 객체는 필요에 따라 [AcpHalAllocateShapeContexts](/reference/audio/acphal/functions/acphalallocateshapecontexts) 및 [AcpHalCreate](/reference/audio/acphal/functions/acphalcreate)를 사용하여 다시 할당/생성해야 합니다.

## Requirements

**Header:** acphal.h

**지원 플랫폼:** XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## See also

[ACP\_MESSAGE\_TYPE](/reference/audio/acphal/enums/acp_message_type)\
[AcpHal](/reference/audio/acphal/acphal_members)


## Related topics

- [ACP_MESSAGE](/ko/reference/audio/acphal/structs/acp_message.md)
- [AcpHal](/ko/reference/audio/acphal/acphal_members.md)
- [ACP_MESSAGE_TYPE](/ko/reference/audio/acphal/enums/acp_message_type.md)
- [ACP_COMMAND_MESSAGE](/ko/reference/audio/acphal/structs/acp_command_message.md)
- [ACP_MESSAGE_COMMAND_COMPLETED](/ko/reference/audio/acphal/structs/acp_message_command_completed.md)