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

Paramètres transmis à [XApuConnect](/fr-CA/reference/audio/xapu/functions/xapuconnect) pour allouer des ressources.

## Syntaxe

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

### Membres

*processType*\
Type : [XApuProcessType](/fr-CA/reference/audio/xapu/enums/xapuprocesstype)

Type de processus qui sera effectué pour tous les flux traités par le client XAPU. Un même client ne peut pas effectuer plus d'un type de processus.

*maxStreamCount*\
Type : uint32\_t

Nombre maximal de flux qui devraient être activés simultanément pour le client XAPU. La valeur minimale est 1, la valeur maximale est 500

*maxQueuedCommandsPerStream*\
Type : uint32\_t

Taille de la file d'attente de commandes pour un flux. La valeur minimale est 1, la valeur maximale est 16. La taille totale de la file d'attente de commandes pour le client XAPU est *maxStreamCount* \* *maxQueuedCommandsPerStream*

*baseDataLength*\
Type : uint32\_t

Allocation de mémoire requise, en octets, pour traiter *maxStreamCount* flux, ce qui comprend les mémoires tampons d'entrée, de sortie et de traitement.
Par exemple, *baseDataLength* pour le cas DecodeOpus d'un flux Opus stéréo avec des paquets de 20 millisecondes (960 trames) peut être
la longueur maximale prévue des paquets d'entrée en octets, plus le nombre de trames de sortie multiplié par le nombre de canaux multiplié par la taille d'une variable float.

Pour XApuProcessType::DecodeOpus, la formule générale est :

baseDataLength = maxStreamCount x maxQueuedCommandsPerStream x (MaxOpusPacketInBytes + (MaxFrameCountPerPacket x ChannelCount x sizeof(float))
où *MaxFrameCountPerPacket* doit être un multiple de 16

Pour [XApuProcessType::DecodeConvertOpus](/fr-CA/reference/audio/xapu/enums/xapuprocesstype), la formule générale est :
baseDataLength = (maxStreamCount x maxQueuedCommandsPerStream x (MaxOpusPacketInBytes + (MaxFrameCountPerPacket x ChannelCount x sizeof(float)))

* (maxStreamCount x XApuDecodeConvertActivateCommand::processingBufferLength)
  où *MaxFrameCountPerPacket* doit être un multiple de 16

*maxFrameCountPerOutput*\
Type : uint32\_t

Ce paramètre définit la durée de sortie, en nombre de trames, lorsque la XAPU fonctionne avec les types [XApuProcessType::ConvertPCM](/fr-CA/reference/audio/xapu/enums/xapuprocesstype) ou [XApuProcessType::DecodeConvertOpus](/fr-CA/reference/audio/xapu/enums/xapuprocesstype).
Pour [XApuProcessType::ConvertPCM](/fr-CA/reference/audio/xapu/enums/xapuprocesstype) ou [XApuProcessType::DecodeConvertOpus](/fr-CA/reference/audio/xapu/enums/xapuprocesstype), ce paramètre doit être réglé à l'une des valeurs suivantes : 256, 480, 512, 960, 1024.
Ce paramètre doit être réglé à zéro pour [XApuProcessType::DecodeOpus](/fr-CA/reference/audio/xapu/enums/xapuprocesstype)

*options*\
Type : [XApuConnectOptions](/fr-CA/reference/audio/xapu/enums/xapuconnectoptions)

Options de connexion.

## Remarques

Utilisé par `XApuConnectInputParameters` pour transmettre des paramètres à `XApuConnect`. `XApuConnect` alloue les ressources nécessaires pour une unité de traitement audio (XAPU). `XApuCommandId` définit le paramètre de commande de base à envoyer à la XAPU et à recevoir de celle-ci.

## Configuration requise

**En-tête :** xapu.h

**Plateformes prises en charge :** XBOX Series X|S

## Voir aussi

[XApuCommandId](/fr-CA/reference/audio/xapu/structs/xapucommandid)\
[XApuConnect](/fr-CA/reference/audio/xapu/functions/xapuconnect)\
[XApuDecodeConvertCommand](/fr-CA/reference/audio/xapu/structs/xapudecodeconvertcommand)\
[XAPU](/fr-CA/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)
- [XApuProcessType](/reference/audio/xapu/enums/xapuprocesstype.md)
- [XApuDecodeConvertActivateCommand](/reference/audio/xapu/structs/xapudecodeconvertactivatecommand.md)