> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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](https://docs.xbox.com/pt-BR/reference/audio/xapu/structs/xapuconnectoutputparameters.md) é sinalizado quando o resultado do comando estiver pronto. Para usar esse sinalizador, o chamador deve definir [XApuConnectOptions::EnableResultReadyEvent](https://docs.xbox.com/pt-BR/reference/audio/xapu/enums/xapuconnectoptions.md) em [XApuConnect](https://docs.xbox.com/pt-BR/reference/audio/xapu/functions/xapuconnect.md). Consulte a descrição de [XApuConnectOutputParameters::resultReadyEvent](https://docs.xbox.com/pt-BR/reference/audio/xapu/structs/xapuconnectoutputparameters.md). |
| Flush | Libera os dados de saída, se disponíveis, sem esperar por mais dados de entrada. Esse sinalizador funciona somente com [XApuProcessType::Process](https://docs.xbox.com/pt-BR/reference/audio/xapu/enums/xapuprocesstype.md); caso contrário, será ignorado. Esse sinalizador pode ser usado somente com [XApuProcessType::DecodeConvertOpus](https://docs.xbox.com/pt-BR/reference/audio/xapu/enums/xapuprocesstype.md) e [XApuProcessType::ConvertPCM](https://docs.xbox.com/pt-BR/reference/audio/xapu/enums/xapuprocesstype.md). |
| Decoder | Quando definido, redefine o decodificador somente no modo de processamento [XApuProcessType::DecodeConvertOpus](https://docs.xbox.com/pt-BR/reference/audio/xapu/enums/xapuprocesstype.md). Esse sinalizador funciona somente com [XApuCommandType::Reset](https://docs.xbox.com/pt-BR/reference/audio/xapu/enums/xapucommandtype.md); 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](https://docs.xbox.com/pt-BR/reference/audio/xapu/enums/xapucommandtype.md) com o sinalizador [XApuCommandOptions::Decoder](https://docs.xbox.com/pt-BR/reference/audio/xapu/enums/xapucommandoptions.md) 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](https://docs.xbox.com/pt-BR/reference/audio/xapu/structs/xapuconnectoutputparameters.md) para sinalizar quando o resultado do comando estiver pronto. O comando do decodificador usa somente o método [XApuProcessType::DecodeConvertOpus](https://docs.xbox.com/pt-BR/reference/audio/xapu/enums/xapuprocesstype.md). Caso contrário, o decodificador Opus será redefinido usando o método [XApuCommandType::Reset](https://docs.xbox.com/pt-BR/reference/audio/xapu/enums/xapucommandtype.md).

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](https://docs.xbox.com/pt-BR/reference/audio/xapu/structs/xapucommandid.md)\
[XApuConnectOutputParameters](https://docs.xbox.com/pt-BR/reference/audio/xapu/structs/xapuconnectoutputparameters.md)\
[XAPU](https://docs.xbox.com/pt-BR/reference/audio/xapu/xapu_members.md)


## Related topics

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