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

> ACP_MESSAGE

# ACP\_MESSAGE

ACP에서 온 메시지입니다.

## Syntax

```cpp theme={null}
typedef struct ACP_MESSAGE {  
    UINT32 type;  
    UINT32 droppedMessageCount;  
    UINT32 usec;  
    union  
    {  
        ACP_MESSAGE_AUDIO_FRAME_START audioFrameStart;  
        ACP_MESSAGE_FLOWGRAPH_COMPLETED flowgraphCompleted;  
        ACP_MESSAGE_SHAPE_COMMAND_BLOCKED shapeCommandBlocked;  
        ACP_MESSAGE_COMMAND_COMPLETED commandCompleted;  
        ACP_MESSAGE_FLOWGRAPH_TERMINATED flowgraphTerminated;  
        ACP_MESSAGE_ERROR error;  
    };  
} ACP_MESSAGE  
```

### Members

*type*\
Type: UINT32

메시지 유형입니다. [ACP\_MESSAGE\_TYPE](/reference/audio/acphal/enums/acp_message_type)을 참조하세요.

*droppedMessageCount*\
Type: UINT32

이 메시지 이전에 삭제된 메시지의 수입니다.

*usec*\
Type: UINT32

이 메시지가 생성된 시각입니다.

*audioFrameStart*\
Type: [ACP\_MESSAGE\_AUDIO\_FRAME\_START](/reference/audio/acphal/structs/acp_message_audio_frame_start)

[ACP\_MESSAGE\_AUDIO\_FRAME\_START](/reference/audio/acphal/structs/acp_message_audio_frame_start) 메시지입니다.

*flowgraphCompleted*\
Type: [ACP\_MESSAGE\_FLOWGRAPH\_COMPLETED](/reference/audio/acphal/structs/acp_message_flowgraph_completed)

[ACP\_MESSAGE\_FLOWGRAPH\_COMPLETED](/reference/audio/acphal/structs/acp_message_flowgraph_completed) 메시지입니다.

*shapeCommandBlocked*\
Type: [ACP\_MESSAGE\_SHAPE\_COMMAND\_BLOCKED](/reference/audio/acphal/structs/acp_message_shape_command_blocked)

[ACP\_MESSAGE\_SHAPE\_COMMAND\_BLOCKED](/reference/audio/acphal/structs/acp_message_shape_command_blocked) 메시지입니다.

*commandCompleted*\
Type: [ACP\_MESSAGE\_COMMAND\_COMPLETED](/reference/audio/acphal/structs/acp_message_command_completed)

[ACP\_MESSAGE\_COMMAND\_COMPLETED](/reference/audio/acphal/structs/acp_message_command_completed) 메시지입니다.

*flowgraphTerminated*\
Type: [ACP\_MESSAGE\_FLOWGRAPH\_TERMINATED](/reference/audio/acphal/structs/acp_message_flowgraph_terminated)

[ACP\_MESSAGE\_FLOWGRAPH\_TERMINATED](/reference/audio/acphal/structs/acp_message_flowgraph_terminated) 메시지입니다.

*error*\
Type: [ACP\_MESSAGE\_ERROR](/reference/audio/acphal/structs/acp_message_error)

[ACP\_MESSAGE\_ERROR](/reference/audio/acphal/structs/acp_message_error) 메시지입니다.

## Remarks

메시지 유형을 확인하려면 *type* 멤버를 검사하세요.

메시지 큐에 있는 메시지의 수를 확인하려면 [GetNumMessages](/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_getnummessages) 메서드를 사용하세요. 큐에서 가장 오래된 메시지를 가져오려면 [PopMessage](/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_popmessage) 메서드를 사용하세요.

## Requirements

**Header:** acphal.h

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

## See also

[ACP\_MESSAGE\_TYPE](/reference/audio/acphal/enums/acp_message_type)\
[GetNumMessages](/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_getnummessages)\
[PopMessage](/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_popmessage)\
[AcpHal](/reference/audio/acphal/acphal_members)


## Related topics

- [ACP_MESSAGE_TYPE](/ko/reference/audio/acphal/enums/acp_message_type.md)
- [IAcpHal::PopMessage](/ko/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_popmessage.md)
- [SHAPE 오디오 플로우그래프 구성 모범 사례](/ko/build/console-features/audio/overviews/best-practices-audio-flowgraph-construction.md)
- [SHAPE 개요](/ko/build/console-features/audio/overviews/shape-overview.md)
- [AcpHal](/ko/reference/audio/acphal/acphal_members.md)