> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ACP_MESSAGE

> ACP_MESSAGE

# ACP\_MESSAGE

ACP からのメッセージ。

## 構文

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

### メンバー

*type*\
型: UINT32

メッセージ タイプ。[ACP\_MESSAGE\_TYPE](https://docs.xbox.com/ja-jp/reference/audio/acphal/enums/acp_message_type.md) を参照してください。

*droppedMessageCount*\
型: UINT32

このメッセージより前にドロップされたメッセージの数。

*usec*\
型: UINT32

このメッセージが構築された時刻。

*audioFrameStart*\
型: [ACP\_MESSAGE\_AUDIO\_FRAME\_START](https://docs.xbox.com/ja-jp/reference/audio/acphal/structs/acp_message_audio_frame_start.md)

[ACP\_MESSAGE\_AUDIO\_FRAME\_START](https://docs.xbox.com/ja-jp/reference/audio/acphal/structs/acp_message_audio_frame_start.md) メッセージ。

*flowgraphCompleted*\
型: [ACP\_MESSAGE\_FLOWGRAPH\_COMPLETED](https://docs.xbox.com/ja-jp/reference/audio/acphal/structs/acp_message_flowgraph_completed.md)

[ACP\_MESSAGE\_FLOWGRAPH\_COMPLETED](https://docs.xbox.com/ja-jp/reference/audio/acphal/structs/acp_message_flowgraph_completed.md) メッセージ。

*shapeCommandBlocked*\
型: [ACP\_MESSAGE\_SHAPE\_COMMAND\_BLOCKED](https://docs.xbox.com/ja-jp/reference/audio/acphal/structs/acp_message_shape_command_blocked.md)

[ACP\_MESSAGE\_SHAPE\_COMMAND\_BLOCKED](https://docs.xbox.com/ja-jp/reference/audio/acphal/structs/acp_message_shape_command_blocked.md) メッセージ。

*commandCompleted*\
型: [ACP\_MESSAGE\_COMMAND\_COMPLETED](https://docs.xbox.com/ja-jp/reference/audio/acphal/structs/acp_message_command_completed.md)

[ACP\_MESSAGE\_COMMAND\_COMPLETED](https://docs.xbox.com/ja-jp/reference/audio/acphal/structs/acp_message_command_completed.md) メッセージ。

*flowgraphTerminated*\
型: [ACP\_MESSAGE\_FLOWGRAPH\_TERMINATED](https://docs.xbox.com/ja-jp/reference/audio/acphal/structs/acp_message_flowgraph_terminated.md)

[ACP\_MESSAGE\_FLOWGRAPH\_TERMINATED](https://docs.xbox.com/ja-jp/reference/audio/acphal/structs/acp_message_flowgraph_terminated.md) メッセージ。

*error*\
型: [ACP\_MESSAGE\_ERROR](https://docs.xbox.com/ja-jp/reference/audio/acphal/structs/acp_message_error.md)

[ACP\_MESSAGE\_ERROR](https://docs.xbox.com/ja-jp/reference/audio/acphal/structs/acp_message_error.md) メッセージ。

## 解説

メッセージの種類を判定するには、*type* メンバーを確認します。

メッセージ キュー内のメッセージ数を確認するには、[GetNumMessages](https://docs.xbox.com/ja-jp/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_getnummessages.md) メソッドを使用します。キューから最も古いメッセージを取得するには、[PopMessage](https://docs.xbox.com/ja-jp/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_popmessage.md) メソッドを使用します。

## 要件

**ヘッダー:** acphal.h

**サポート対象プラットフォーム:** XBOX One ファミリー本体、XBOX Series 本体

## 関連項目

[ACP\_MESSAGE\_TYPE](https://docs.xbox.com/ja-jp/reference/audio/acphal/enums/acp_message_type.md)\
[GetNumMessages](https://docs.xbox.com/ja-jp/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_getnummessages.md)\
[PopMessage](https://docs.xbox.com/ja-jp/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_popmessage.md)\
[AcpHal](https://docs.xbox.com/ja-jp/reference/audio/acphal/acphal_members.md)


## Related topics

- [ACP_MESSAGE_TYPE](https://docs.xbox.com/ja-jp/reference/audio/acphal/enums/acp_message_type.md)
- [IAcpHal::PopMessage](https://docs.xbox.com/ja-jp/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_popmessage.md)
- [AcpHal](https://docs.xbox.com/ja-jp/reference/audio/acphal/acphal_members.md)
- [SHAPE オーディオ フローグラフ構築のベスト プラクティス](https://docs.xbox.com/ja-jp/build/console-features/audio/overviews/best-practices-audio-flowgraph-construction.md)
- [SHAPE の概要](https://docs.xbox.com/ja-jp/build/console-features/audio/overviews/shape-overview.md)