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

# XApuCommandId

> XApuCommandId

# XApuCommandId

Define os parâmetros básicos de comando a serem enviados e recebidos da XAPU. Todos os outros comandos são expandidos a partir desse tipo.

## Sintaxe

```cpp theme={null}
typedef struct XApuCommandId {  
    XApuCommandType type;  
    uint32_t streamIndex;  
    uint32_t sequence;  
    XApuCommandOptions options;  
    void* context;  
} XApuCommandId  
```

### Membros

*type*\
Tipo: [XApuCommandType](/pt-BR/reference/audio/xapu/enums/xapucommandtype)

Tipo de comando para instruir o hardware sobre como processar os dados associados neste comando.

*streamIndex*\
Tipo: uint32\_t

Índice do fluxo. O valor deve estar entre 0 e [XApuConnectInputParameters::maxStreamCount](/pt-BR/reference/audio/xapu/structs/xapuconnectinputparameters) - 1. Cada fluxo deve ter um valor de índice exclusivo, e o chamador é responsável por atribuir esse valor.

*sequence*\
Tipo: uint32\_t

Esse valor não é alterado pela XAPU, e cabe ao chamador decidir como usá-lo. Ele pode ser usado como um número de sequência de comando que deve aumentar com o tempo para acompanhar os pacotes à medida que saem da fila de resultados. A XAPU não reorganizará a ordem dos pacotes de acordo com esse número de sequência, nem retornará um erro se esse número retroceder ou se houver uma lacuna em relação a um valor anterior.

*options*\
Tipo: [XApuCommandOptions](/pt-BR/reference/audio/xapu/enums/xapucommandoptions)

Opções de comando. Algumas opções podem ser aplicadas a todos os tipos de comando, como [XApuCommandOptions::SignalOnCompletion](/pt-BR/reference/audio/xapu/enums/xapucommandoptions); outras funcionam para um tipo de comando específico, como [XApuCommandOptions::Flush](/pt-BR/reference/audio/xapu/enums/xapucommandoptions) e [XApuCommandOptions::Decoder](/pt-BR/reference/audio/xapu/enums/xapucommandoptions).

*context*\
Tipo: void\*

Um espaço reservado opcional para dados do usuário que a XAPU passará internamente, como estão, desde o estágio de enfileiramento do comando até o estágio de remoção do resultado da fila. O chamador pode passar quaisquer dados que caibam em um valor sem sinal de 64 bits, como carimbos de data/hora.

## Comentários

Usado por [XApuCommandId](/pt-BR/reference/audio/xapu/structs/xapucommandid) para definir os parâmetros básicos de comando enviados e recebidos da XAPU. Todos os outros comandos são expandidos a partir desse tipo. Para obter mais informações sobre os parâmetros de processamento de ativação de decodificação e conversão, consulte [XApuDecodeConvertActivateCommand](/pt-BR/reference/audio/xapu/structs/xapudecodeconvertactivatecommand) e [XApuDecodeConvertCommand](/pt-BR/reference/audio/xapu/structs/xapudecodeconvertcommand). Para obter informações sobre como enviar um comando para a fila de entrada da XAPU, consulte [XApuEnqueueCommand](/pt-BR/reference/audio/xapu/functions/xapuenqueuecommand).

## Requisitos

**Cabeçalho:** xapu.h

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

## Confira também

[XApuDequeueResult](/pt-BR/reference/audio/xapu/functions/xapudequeueresult)\
[XApuResult](/pt-BR/reference/audio/xapu/structs/xapuresult)\
[XAPU](/pt-BR/reference/audio/xapu/xapu_members)


## Related topics

- [XApuCommandType](/pt-BR/reference/audio/xapu/enums/xapucommandtype.md)
- [XApuDecodeConvertActivateCommand](/pt-BR/reference/audio/xapu/structs/xapudecodeconvertactivatecommand.md)
- [XApuCommandOptions](/pt-BR/reference/audio/xapu/enums/xapucommandoptions.md)
- [XApuEnqueueCommand](/pt-BR/reference/audio/xapu/functions/xapuenqueuecommand.md)
- [XApuDecodeConvertCommand](/pt-BR/reference/audio/xapu/structs/xapudecodeconvertcommand.md)