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

# XApuConnectInputParameters

> XApuConnectInputParameters

# XApuConnectInputParameters

Parâmetros passados para [XApuConnect](/pt-BR/reference/audio/xapu/functions/xapuconnect) para alocar recursos.

## Sintaxe

```cpp theme={null}
typedef struct XApuConnectInputParameters {  
    XApuProcessType processType;  
    uint32_t maxStreamCount;  
    uint32_t maxQueuedCommandsPerStream;  
    uint32_t baseDataLength;  
    uint32_t maxFrameCountPerOutput;  
    XApuConnectOptions options;  
} XApuConnectInputParameters  
```

### Membros

*processType*\
Tipo: [XApuProcessType](/pt-BR/reference/audio/xapu/enums/xapuprocesstype)

Tipo de processo que será executado para todos os fluxos processados pelo cliente da XAPU. Um único cliente não pode executar mais de um tipo de processo.

*maxStreamCount*\
Tipo: uint32\_t

Número máximo de fluxos que se espera que sejam ativados simultaneamente para o cliente da XAPU. O valor mínimo é 1, o máximo é 500

*maxQueuedCommandsPerStream*\
Tipo: uint32\_t

Tamanho da fila de comandos para um fluxo. O valor mínimo é 1, o máximo é 16. O tamanho total da fila de comandos para o cliente da XAPU é *maxStreamCount* \* *maxQueuedCommandsPerStream*

*baseDataLength*\
Tipo: uint32\_t

A alocação de memória necessária, em bytes, para processar *maxStreamCount* fluxos, o que inclui os buffers de entrada, de saída e de processamento.
Por exemplo, *baseDataLength* para o caso DecodeOpus de um fluxo Opus estéreo com pacotes de 20 milissegundos (960 quadros) pode ser
o comprimento máximo esperado do pacote de entrada em bytes mais a contagem de quadros de saída vezes o número de canais vezes o tamanho de uma variável float.

Para XApuProcessType::DecodeOpus, a fórmula geral é:

baseDataLength = maxStreamCount x maxQueuedCommandsPerStream x (MaxOpusPacketInBytes + (MaxFrameCountPerPacket x ChannelCount x sizeof(float))
em que *MaxFrameCountPerPacket* deve ser múltiplo de 16

Para [XApuProcessType::DecodeConvertOpus](/pt-BR/reference/audio/xapu/enums/xapuprocesstype), a fórmula geral é:
baseDataLength = (maxStreamCount x maxQueuedCommandsPerStream x (MaxOpusPacketInBytes + (MaxFrameCountPerPacket x ChannelCount x sizeof(float)))

* (maxStreamCount x XApuDecodeConvertActivateCommand::processingBufferLength)
  em que *MaxFrameCountPerPacket* deve ser múltiplo de 16

*maxFrameCountPerOutput*\
Tipo: uint32\_t

Esse parâmetro define a duração da saída em contagem de quadros quando a XAPU está sendo executada nos tipos [XApuProcessType::ConvertPCM](/pt-BR/reference/audio/xapu/enums/xapuprocesstype) ou [XApuProcessType::DecodeConvertOpus](/pt-BR/reference/audio/xapu/enums/xapuprocesstype).
Para [XApuProcessType::ConvertPCM](/pt-BR/reference/audio/xapu/enums/xapuprocesstype) ou [XApuProcessType::DecodeConvertOpus](/pt-BR/reference/audio/xapu/enums/xapuprocesstype), esse parâmetro deve ser definido como um dos seguintes valores: 256, 480, 512, 960, 1024.
Esse parâmetro deve ser definido como zero para [XApuProcessType::DecodeOpus](/pt-BR/reference/audio/xapu/enums/xapuprocesstype)

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

Opções de conexão.

## Comentários

Usado por `XApuConnectInputParameters` para passar parâmetros para `XApuConnect`. `XApuConnect` aloca os recursos necessários para uma Unidade de Processamento de Áudio (XAPU). `XApuCommandId` define o parâmetro básico de comando a ser enviado e recebido da XAPU.

## Requisitos

**Cabeçalho:** xapu.h

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

## Confira também

[XApuCommandId](/pt-BR/reference/audio/xapu/structs/xapucommandid)\
[XApuConnect](/pt-BR/reference/audio/xapu/functions/xapuconnect)\
[XApuDecodeConvertCommand](/pt-BR/reference/audio/xapu/structs/xapudecodeconvertcommand)\
[XAPU](/pt-BR/reference/audio/xapu/xapu_members)


## Related topics

- [XApuConnectInputParameters](/reference/audio/xapu/structs/xapuconnectinputparameters.md)
- [XApuConnect](/reference/audio/xapu/functions/xapuconnect.md)
- [XApuConnectOptions](/es/reference/audio/xapu/enums/xapuconnectoptions.md)