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

> ACP_COMMAND_UPDATE_XMA_CONTEXT_ENTRY

# ACP\_COMMAND\_UPDATE\_XMA\_CONTEXT\_ENTRY

SHAPE\_XMA\_CONTEXT를 업데이트하기 위한 항목입니다.

## Syntax

```cpp theme={null}
typedef struct ACP_COMMAND_UPDATE_XMA_CONTEXT_ENTRY {  
    UINT32 contextIndex;  
    APU_ADDRESS ptrRead0;  
    APU_ADDRESS ptrRead1;  
    UINT16 sizeRead0;  
    UINT16 sizeRead1;  
    UINT16 writeBufferOffsetRead;  
    UINT16 validBuffer;  
} ACP_COMMAND_UPDATE_XMA_CONTEXT_ENTRY  
```

### Members

*contextIndex*\
Type: UINT32

0에서 ACP\_MAX\_NUM\_XMA\_CONTEXTS 범위 내의 인덱스입니다.

*ptrRead0*\
Type: APU\_ADDRESS

SHAPE\_XMA\_CONTEXT::ptrRead0의 기존 값을 대체합니다.

*ptrRead1*\
Type: APU\_ADDRESS

SHAPE\_XMA\_CONTEXT::ptrRead1의 기존 값을 대체합니다.

*sizeRead0*\
Type: UINT16

SHAPE\_XMA\_CONTEXT::sizeRead0의 기존 값을 대체합니다.

*sizeRead1*\
Type: UINT16

SHAPE\_XMA\_CONTEXT::sizeRead1의 기존 값을 대체합니다.

*writeBufferOffsetRead*\
Type: UINT16

SHAPE\_XMA\_CONTEXT::writeBufferOffsetRead의 기존 값을 대체합니다.

*validBuffer*\
Type: UINT16

SHAPE\_XMA\_CONTEXT::validBuffer의 기존 값을 대체합니다.

## Remarks

이 구조체는 단일 PCM 컨텍스트를 업데이트하기 위해 `ACP_COMMAND_UPDATE_CONTEXTS` 및 `ACP_COMMAND_UPDATE_ALL_CONTEXTS` 명령에서 사용됩니다. 이 명령은 오디오 프레임당 소수의 컨텍스트만 업데이트할 때 사용하세요. 많은 수의 컨텍스트를 업데이트하는 것은 효율적이지 않습니다. 자세한 내용은 [ACP 개요의 오디오 렌더링 섹션](/build/console-features/audio/overviews/acp-overview#ID4E6C)을 참조하세요.

## Requirements

**Header:** acphal.h

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

## See also

[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)


## Related topics

- [AcpHal](/ko/reference/audio/acphal/acphal_members.md)
- [ACP_COMMAND_UPDATE_ALL_CONTEXTS](/ko/reference/audio/acphal/structs/acp_command_update_all_contexts.md)
- [ACP_COMMAND_UPDATE_CONTEXTS](/ko/reference/audio/acphal/structs/acp_command_update_contexts.md)
- [ACP_COMMAND_UPDATE_XMA_CONTEXT](/ko/reference/audio/acphal/structs/acp_command_update_xma_context.md)
- [ACP_COMMAND_UPDATE_EQCOMP_CONTEXT_ENTRY](/ko/reference/audio/acphal/structs/acp_command_update_eqcomp_context_entry.md)