> ## 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](/zh-TW/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 公用程式一節](/zh-TW/build/console-features/audio/overviews/acp-overview#ID4EACAC)。

## 需求

**標頭：** acphal.h

**支援的平台：** XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

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


## Related topics

- [ACP_COMMAND_UPDATE_XMA_READ_BUFFER](/reference/audio/acphal/structs/acp_command_update_xma_read_buffer.md)
- [ACP_COMMAND_TYPE](/reference/audio/acphal/enums/acp_command_type.md)
- [AcpHal](/reference/audio/acphal/acphal_members.md)