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

Entrada para atualizar um SHAPE\_XMA\_CONTEXT.

## Sintaxe

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

### Membros

*contextIndex*\
Tipo: UINT32

Índice no intervalo de 0 a ACP\_MAX\_NUM\_XMA\_CONTEXTS.

*ptrRead0*\
Tipo: APU\_ADDRESS

Substitui o valor existente de SHAPE\_XMA\_CONTEXT::ptrRead0.

*ptrRead1*\
Tipo: APU\_ADDRESS

Substitui o valor existente de SHAPE\_XMA\_CONTEXT::ptrRead1.

*sizeRead0*\
Tipo: UINT16

Substitui o valor existente de SHAPE\_XMA\_CONTEXT::sizeRead0.

*sizeRead1*\
Tipo: UINT16

Substitui o valor existente de SHAPE\_XMA\_CONTEXT::sizeRead1.

*writeBufferOffsetRead*\
Tipo: UINT16

Substitui o valor existente de SHAPE\_XMA\_CONTEXT::writeBufferOffsetRead.

*validBuffer*\
Tipo: UINT16

Substitui o valor existente de SHAPE\_XMA\_CONTEXT::validBuffer.

## Comentários

Esta estrutura é usada pelos comandos `ACP_COMMAND_UPDATE_CONTEXTS` e `ACP_COMMAND_UPDATE_ALL_CONTEXTS` para atualizar um único contexto PCM. Use o comando para atualizar apenas um pequeno número de contextos por quadro de áudio; atualizar um grande número de contextos não é eficiente. Consulte a [seção Renderização de áudio da Visão geral do ACP](/pt-BR/build/console-features/audio/overviews/acp-overview#ID4E6C) para obter mais detalhes.

## Requisitos

**Cabeçalho:** acphal.h

**Plataformas com suporte:** consoles da família XBOX One e consoles XBOX Series

## Confira também

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


## Related topics

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