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

# XApuCommandOptions

> XApuCommandOptions

# XApuCommandOptions

Define opções para diferentes tipos de comando.

## Sintaxe

```cpp theme={null}
enum class XApuCommandOptions  : uint32_t  
{  
    None = 0,  
    SignalOnCompletion = 1,  
    Flush = 2,  
    Decoder = 4,  
}  
```

## Constantes

| Constante | Descrição |
| - | - |
| None | Nenhuma opção está definida. |
| SignalOnCompletion | Esse sinalizador pode ser aplicado a todos os tipos de comando e, quando definido, [XApuConnectOutputParameters::resultReadyEvent](/pt-BR/reference/audio/xapu/structs/xapuconnectoutputparameters) é sinalizado quando o resultado do comando estiver pronto. Para usar esse sinalizador, o chamador deve definir [XApuConnectOptions::EnableResultReadyEvent](/pt-BR/reference/audio/xapu/enums/xapuconnectoptions) em [XApuConnect](/pt-BR/reference/audio/xapu/functions/xapuconnect). Consulte a descrição de [XApuConnectOutputParameters::resultReadyEvent](/pt-BR/reference/audio/xapu/structs/xapuconnectoutputparameters). |
| Flush | Libera os dados de saída, se disponíveis, sem esperar por mais dados de entrada. Esse sinalizador funciona somente com [XApuProcessType::Process](/pt-BR/reference/audio/xapu/enums/xapuprocesstype); caso contrário, será ignorado. Esse sinalizador pode ser usado somente com [XApuProcessType::DecodeConvertOpus](/pt-BR/reference/audio/xapu/enums/xapuprocesstype) e [XApuProcessType::ConvertPCM](/pt-BR/reference/audio/xapu/enums/xapuprocesstype). |
| Decoder | Quando definido, redefine o decodificador somente no modo de processamento [XApuProcessType::DecodeConvertOpus](/pt-BR/reference/audio/xapu/enums/xapuprocesstype). Esse sinalizador funciona somente com [XApuCommandType::Reset](/pt-BR/reference/audio/xapu/enums/xapucommandtype); caso contrário, será ignorado. Esse sinalizador pode ser usado para redefinir o decodificador somente em um caso de decodificação-conversão durante a busca. Cabe ao chamador usar [XApuCommandType::Reset](/pt-BR/reference/audio/xapu/enums/xapucommandtype) com o sinalizador [XApuCommandOptions::Decoder](/pt-BR/reference/audio/xapu/enums/xapucommandoptions) durante a busca, o loop ou a junção de dois fluxos, mas, quando usado, o chamador deve enviar dados de preroll para evitar o efeito transitório na saída. |

## Comentários

Essa enumeração usa o método [XApuConnectOutputParameters::resultReadyEvent](/pt-BR/reference/audio/xapu/structs/xapuconnectoutputparameters) para sinalizar quando o resultado do comando estiver pronto. O comando do decodificador usa somente o método [XApuProcessType::DecodeConvertOpus](/pt-BR/reference/audio/xapu/enums/xapuprocesstype). Caso contrário, o decodificador Opus será redefinido usando o método [XApuCommandType::Reset](/pt-BR/reference/audio/xapu/enums/xapucommandtype).

Quando o sinalizador Decoder é usado com o comando Reset, ele não apaga os dados que já foram decodificados, mas que ainda estão aguardando para serem processados no HSRC.

## Requisitos

**Cabeçalho:** xapu.h

**Plataformas compatíveis:** XBOX Series X|S

## Confira também

[XApuCommandId](/pt-BR/reference/audio/xapu/structs/xapucommandid)\
[XApuConnectOutputParameters](/pt-BR/reference/audio/xapu/structs/xapuconnectoutputparameters)\
[XAPU](/pt-BR/reference/audio/xapu/xapu_members)


## Related topics

- [XApuCommandId](/pt-BR/reference/audio/xapu/structs/xapucommandid.md)
- [XApuConnectOutputParameters](/pt-BR/reference/audio/xapu/structs/xapuconnectoutputparameters.md)
- [XAPU](/pt-BR/reference/audio/xapu/xapu_members.md)
- [XApuDecodeConvertActivateCommand](/pt-BR/reference/audio/xapu/structs/xapudecodeconvertactivatecommand.md)
- [Visão geral da XAPU](/pt-BR/build/console-features/audio/overviews/xapu-overview.md)