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

# Vue d'ensemble de XMA2

> Fonctionnement de la décompression audio matérielle XMA2 sur XBOX One et comparaison avec le décodage logiciel xWMA pour le contenu audio de jeu XAudio2.

Sur XBOX One, la décompression audio XMA2 est implémentée dans le matériel. En revanche, ce n'est pas le cas de xWMA, qui nécessite un décodage logiciel. XMA2 et xWMA utilisent les mêmes algorithmes de compression, mais xWMA offre une gamme plus large de formats d'encodage. Encodez en XMA2 pour bénéficier des avantages en termes de performances et de compression, mais notez que certaines musiques haute fidélité peuvent mieux sonner si elles sont rendues via xWMA, ce qui nécessiterait des tests d'écoute. Coder XMA2 via `XAudio2` devrait être l'approche la plus simple, mais XMA2 peut être codé directement pour le matériel à l'aide des commandes de l'Audio Control Processor (ACP).

<Note>xWMA et XMA2 trouvent tous deux leur origine dans les codecs développés pour Windows Media Audio (WMA) et ont tous deux été développés spécifiquement pour les jeux XBOX. Le sous-ensemble de codecs et de paramètres disponibles utilisé par XMA2 est plus restreint que celui utilisé par xWMA. Bien que xWMA et XMA2 aient été développés pour XBOX, ils ne sont pas interchangeables : les en-têtes de chaque format de fichier diffèrent, et les formats sont incompatibles avec les versions PC de Windows. Les codecs utilisés pour XMA2 et xWMA sont également légèrement différents, si bien que chacun présentera ses propres artefacts liés au système de compression utilisé.</Note>

Cette rubrique traite des sujets suivants :

* [Encodage XMA2](#ID4E3)
* [Erreur de bus AXI XMA2](#ID4ENC)

<a id="ID4E3" />

## Encodage XMA2

Encodez les données audio en XMA2 à l'aide de l'[outil d'encodage XMA2](/fr/build/console-features/audio/tools/xma2encodertool), fourni dans le cadre du Microsoft Game Development Kit (GDK). Les fichiers XMA2 sont des fichiers .wav qui possèdent l'en-tête de format [XMA2WAVEFORMATEX](/fr/reference/audio/xma2defs/structs/xma2waveformatex) et un bloc `seek` supplémentaire dans la table d'emplacements `Seek`.

Le format XMA2 est compatible avec la XBOX 360, et la table `Seek` doit faire l'objet d'une permutation d'octets `ULONG` pour la XBOX One. Si l'entrée est un fichier .wav, la sortie peut être utilisée sans modification.

Pour permuter les octets de la table `Seek`, utilisez les lignes de code suivantes.

```cpp theme={null}
      for(UINT32 i = 0;(i < xmaformat->BlockCount);i++)
      {
      rgpXMASeekTable[i] = _byteswap_ulong(rgpXMASeekTable[i]);
      }  
```

Envisagez d'ajouter d'abord ce code à votre application pour tester la fonctionnalité, puis éventuellement d'écrire un outil distinct pour effectuer la permutation afin qu'aucun prétraitement ne soit requis de la part de votre application.

Pour la XBOX One, toutes les mémoires tampons d'entrée et de sortie DMA (Direct Memory Access) utilisées avec des graphes de flux, ainsi que tout le contenu XMA soumis à une mémoire tampon source, doivent être allouées à l'aide de la méthode [ApuAlloc](/fr/reference/audio/apu/functions/apualloc) et libérées à l'aide de la méthode [ApuFree](/fr/reference/audio/apu/functions/apufree). C'est ce qu'illustre le code suivant. Notez l'utilisation de l'indicateur `SHAPE_XMA_INPUT_BUFFER_ALIGNMENT` pour garantir que les blocs sont correctement alignés.

```cpp theme={null}
      HRESULT ApuVirtualAllocate(void** virtualAddress,UINT32 sizeInBytes)
      {
        DWORD dwsize = sizeInBytes;
        DWORD change = 0;
        if(FixBlockAlign((DWORD*)&sizeInBytes,SHAPE_XMA_INPUT_BUFFER_SIZE_ALIGNMENT,&change)) // Returns TRUE if an alignment was needed; else, returns FALSE.
        {
          return E_INVALIDARG;
        }
        return ApuAlloc(virtualAddress,NULL,sizeInBytes,SHAPE_XMA_INPUT_BUFFER_ALIGNMENT);
      }

      void ApuVirtualFree(void* virtualAddress)
      {
        if(virtualAddress)
        {
          ApuFree(virtualAddress);
        }
      }

      BOOL FixBlockAlign(DWORD* pBYTES,DWORD BLOCKALIGN,DWORD* pChange)
      {
        if(pBYTES && (BLOCKALIGN > 1))
        {
          DWORD bytes = (*pBYTES);
          (*pBYTES) /=  BLOCKALIGN;
          (*pBYTES) *=  BLOCKALIGN;
          if(pChange)
          {
            (*pChange) = bytes&mdash;(*pBYTES);
            if((*pChange) > 0)
            {
              return TRUE;
            }
          }
        }
        return FALSE;
      }  
```

Pour plus d'informations sur l'utilisation des champs de la structure avec un fichier encodé en XMA2, consultez la structure [XMA2WAVEFORMATEX](/fr/reference/audio/xma2defs/structs/xma2waveformatex).

<a id="ID4ENC" />

## Erreur de bus AXI XMA2

Un bogue de longue date dans le décodeur matériel XMA (et sur XBOX 360) exige que les titres fournissent une solution de contournement s'ils utilisent directement `AcpHal`. `XAudio2` fournit déjà cette solution de contournement. Toutefois, tant que l'outil d'encodage XMA2 n'a pas été mis à jour, tenez compte des informations suivantes.

Lors du décodage de flux binaires XMA avec une seule mémoire tampon d'entrée XMA, vous pouvez déclencher une erreur de bus AXI si les 64 derniers octets de la mémoire tampon XMA contiennent des données encodées. Un flux binaire XMA contient rarement des données encodées dans les 64 derniers octets. Néanmoins, ce cas doit être géré pour éviter l'erreur de bus AXI. Tant que l'outil d'encodage XMA2 n'a pas été mis à jour pour garantir qu'aucun fichier encodé ne contient de données encodées dans les 64 derniers octets du flux binaire, vous pouvez éviter ce problème à l'aide de l'une des méthodes suivantes.

* Utilisez toujours les deux mémoires tampons d'entrée XMA, et ne définissez jamais le pointeur de l'une ou l'autre mémoire tampon d'entrée sur une valeur non valide.

* Définissez le pointeur de la mémoire tampon d'entrée inutilisée sur la même valeur que le pointeur de l'autre mémoire tampon d'entrée, même si vous n'activez pas l'autre mémoire tampon. Voici un exemple.

```cpp theme={null}
      context->ptrRead1 = context->ptrRead0  
```

* Lors de la génération du contenu, utilisez un outil hors connexion pour analyser vos fichiers XMA. Si l'un des 64 derniers octets du flux binaire XMA encodé a une valeur autre que 0xFF, réencodez le fichier.

Chacune de ces méthodes empêche le prélecteur XMA de lire une adresse non valide.

<a id="ID4EFD" />

## Documentation de référence de l'API

* [APU (contenu de l'API)](/fr/reference/audio/apu/apu_members)
  * Fonctions
    * [ApuAlloc](/fr/reference/audio/apu/functions/apualloc)
    * [ApuFree](/fr/reference/audio/apu/functions/apufree)
* [XMA2Defs (contenu de l'API)](/fr/reference/audio/xma2defs/xma2defs_members)
  * Structures
    * [XMA2WAVEFORMATEX](/fr/reference/audio/xma2defs/structs/xma2waveformatex)

## Voir aussi

[Outil d'encodage XMA2](/fr/build/console-features/audio/tools/xma2encodertool)


## Related topics

- [Vue d'ensemble de XBOX Series X|S](/fr/paths/series-xs/overview.md)
- [Vue d'ensemble de l'accessibilité GDK](/fr/build/game-principles/accessibility/accessibility-overview.md)
- [Vue d'ensemble de Windows & ROG XBOX Ally](/fr/paths/windows/overview.md)
- [Vue d'ensemble de Godot et des moteurs communautaires](/fr/paths/community-engines/overview.md)
- [Vue d'ensemble de Play Anywhere (console + PC)](/fr/paths/play-anywhere/overview.md)