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

> ACP_COMMAND_ENABLE_OR_DISABLE_XMA_CONTEXTS

# ACP\_COMMAND\_ENABLE\_OR\_DISABLE\_XMA\_CONTEXTS

Comando para habilitar ou desabilitar uma série de contextos XMA.

## Sintaxe

```cpp theme={null}
typedef struct ACP_COMMAND_ENABLE_OR_DISABLE_XMA_CONTEXTS {  
    UINT32 context[SHAPE_NUM_XMA_CONTEXT_BITFIELDS];  
} ACP_COMMAND_ENABLE_OR_DISABLE_XMA_CONTEXTS  
```

### Membros

*context*\
Tipo: UINT32\[SHAPE\_NUM\_XMA\_CONTEXT\_BITFIELDS]

Campo de bits de contextos, em que o elemento da matriz = context / 32 e a máscara = 1 \<\< (context % 32).

## Comentários

Se o comando `ACP_COMMAND_TYPE_DISABLE_XMA_CONTEXTS` for emitido, a mensagem `ACP_MESSAGE_TYPE_COMMAND_COMPLETED` será enviada depois que todos os contextos XMA forem desabilitados e o decodificador não estiver mais processando nenhum dos contextos. Isso significa que, quando a mensagem de *comando concluído* for recebida, um título estará livre para modificar as estruturas de contexto.

O motivo pelo qual a mensagem de *comando concluído* é enviada depois que o contexto é desabilitado pelo decodificador, e não simplesmente depois que ele é marcado como desabilitado, é que o decodificador XMA pode estar no meio de uma operação no contexto, que não pode ser interrompida. Esse comportamento é o mesmo do XBOX 360.

Se toda a matriz de contextos for inicializada com zero, use o seguinte para definir o bit de cada índice de contexto:

`context[contextIndex >> SHAPE_XMA_CONTEXT_INDEX_SHIFT] |= 1 << (contextIndex & SHAPE_XMA_CONTEXT_BIT_MASK);`

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

- [ACP_COMMAND_ENABLE_OR_DISABLE_XMA_CONTEXT](/pt-BR/reference/audio/acphal/structs/acp_command_enable_or_disable_xma_context.md)
- [ACP_COMMAND_TYPE](/pt-BR/reference/audio/acphal/enums/acp_command_type.md)
- [AcpHal](/pt-BR/reference/audio/acphal/acphal_members.md)
- [ACP_COMMAND_UPDATE_XMA_CONTEXT](/pt-BR/reference/audio/acphal/structs/acp_command_update_xma_context.md)
- [ACP_COMMAND_UPDATE_XMA_CONTEXT_ENTRY](/pt-BR/reference/audio/acphal/structs/acp_command_update_xma_context_entry.md)