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

> ACP_COMMAND_UPDATE_XMA_READ_BUFFER

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

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

## 構文

```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 ユーティリティ セクション](/build/console-features/audio/overviews/acp-overview#ID4EACAC)を参照してください。

## 要件

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

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

## 関連項目

[ACP\_COMMAND\_TYPE](/reference/audio/acphal/enums/acp_command_type)\
[SubmitCommand](/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_submitcommand)\
[AcpHal](/reference/audio/acphal/acphal_members)