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

> ACP_COMMAND_UPDATE_XMA_READ_BUFFER

# ACP\_COMMAND\_UPDATE\_XMA\_READ\_BUFFER

エンコード済みデータのストリーミングに必要な、[SHAPE\_XMA\_CONTEXT](https://docs.xbox.com/ja-jp/reference/audio/shapexmacontext/structs/shape_xma_context.md) のすべての要素を更新します。

## 構文

```cpp theme={null}
typedef struct ACP_COMMAND_UPDATE_XMA_READ_BUFFER {  
    UINT32 contextIndex;  
    UINT32 bufferIndex;  
    UINT32 bufferSize;  
    UINT32 changeSize;  
    UINT32 changeAddress;  
    APU_ADDRESS bufferAddress;  
} ACP_COMMAND_UPDATE_XMA_READ_BUFFER  
```

### メンバー

*contextIndex*\
型: UINT32

更新対象のコンテキストのインデックス。

*bufferIndex*\
型: UINT32

0 = 左入力バッファー、1 = 右入力バッファー。

*bufferSize*\
型: UINT32

バッファーのサイズ。

*changeSize*\
型: UINT32

0 = 元のサイズを保持、1 = 新しいサイズを使用。

*changeAddress*\
型: UINT32

0 = 元のアドレスを保持、1 = 新しいアドレスを使用。

*bufferAddress*\
型: APU\_ADDRESS

バッファーの物理アドレス。

## 解説

この構造体は `ACP_COMMAND_TYPE_UPDATE_XMA_READ_BUFFER` コマンドによって使用されます。SHAPE によってコンテキストが使用中の場合、読み取りオフセットを更新することはできません。関連するコマンドについては、[ACP の概要の XMA ユーティリティ セクション](https://docs.xbox.com/ja-jp/build/console-features/audio/overviews/acp-overview.md#ID4EACAC)を参照してください。

## 要件

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

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

## 関連項目

[ACP\_COMMAND\_TYPE](https://docs.xbox.com/ja-jp/reference/audio/acphal/enums/acp_command_type.md)\
[SubmitCommand](https://docs.xbox.com/ja-jp/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_submitcommand.md)\
[AcpHal](https://docs.xbox.com/ja-jp/reference/audio/acphal/acphal_members.md)


## Related topics

- [ACP_COMMAND_TYPE](https://docs.xbox.com/ja-jp/reference/audio/acphal/enums/acp_command_type.md)
- [AcpHal](https://docs.xbox.com/ja-jp/reference/audio/acphal/acphal_members.md)
- [ACP_COMMAND_UPDATE_XMA_CONTEXT](https://docs.xbox.com/ja-jp/reference/audio/acphal/structs/acp_command_update_xma_context.md)
- [ACP_COMMAND_UPDATE_XMA_CONTEXT_ENTRY](https://docs.xbox.com/ja-jp/reference/audio/acphal/structs/acp_command_update_xma_context_entry.md)
- [ACP_COMMAND_INCREMENT_XMA_WRITE_BUFFER_OFFSET_READ](https://docs.xbox.com/ja-jp/reference/audio/acphal/structs/acp_command_increment_xma_write_buffer_offset_read.md)