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

# XWMAEncoder

> XWMAEncoder

Encode une mémoire tampon d'entrée en données xWMA.

<a id="syntaxSection" />

## Syntaxe

```cpp theme={null}
HRESULT XWMAEncoder(
         const BYTE *pInputBuffer,
         DWORD inputBufferSize,
         const WAVEFORMATEX *pInputFormat,
         DWORD outputBitrate,
         BYTE **ppEncodedBuffer,
         DWORD *pEncodedBufferSize,
         WAVEFORMATEX **ppEncodedBufferFormat,
         DWORD *pEncodedBufferFormatSize,
         DWORD **ppDecodedPacketCumulativeBytes,
         DWORD *pDecodedPacketCumulativeBytesSize)  
```

<a id="ID4EG" />

### Paramètres

*pInputBuffer*
Type : BYTE \*

Pointeur vers la mémoire tampon d'entrée contenant les données PCM; elle doit contenir au moins une trame.

*inputBufferSize*
Type : DWORD

Taille de la mémoire tampon d'entrée, en octets.

*pInputFormat*
Type : WAVEFORMATEX \*

Format de la mémoire tampon d'entrée.

*outputBitrate*
Type : DWORD

Spécifie le débit binaire demandé, qui doit être l'une des valeurs suivantes : 20000, 32000, 48000, 64000, 96000, 160000 ou 192000.

*ppEncodedBuffer*
Type : BYTE \*\*

Pointeur vers un pointeur vers les données encodées.

*pEncodedBufferSize*
Type : DWORD \*

Pointeur vers un DWORD contenant la taille des données encodées, en octets.

*ppEncodedBufferFormat*
Type : WAVEFORMATEX \*\*

Pointeur vers un pointeur vers la structure de format de sortie.

*pEncodedBufferFormatSize*
Type : DWORD \*

Pointeur vers un DWORD contenant la taille de la structure de format de sortie.

*ppDecodedPacketCumulativeBytes*
Type : DWORD \*\*

Tableau des tailles de données cumulées des paquets décodés (utilisez free \[] pour le libérer). Chaque élément correspond au nombre d'octets accumulés lorsque le paquet WMA correspondant est décodé dans l'ordre; le tableau doit comporter PacketCount éléments. PacketCount est défini dans la structure XAUDIO2\_BUFFER\_WMA.

*pDecodedPacketCumulativeBytesSize*
Type : DWORD \*

Taille des données cumulées des paquets décodés (en octets). Le nombre de paquets = \*pDecodedPacketCumulativeBytesSize / sizeof(DWORD);

<a id="ID4EO" />

### Valeur de retour

Type : HRESULT

Retourne S\_OK en cas de réussite; sinon, retourne un code d'erreur figurant dans le tableau suivant.

| Code d'erreur | Description |
| - | - |
| XWMA\_E\_UNSUPPORTED\_FORMATTAG | La balise de format doit être WAVE\_FORMAT\_PCM ou WAVE\_FORMAT\_IEEE\_FLOAT. |
| XWMA\_E\_UNSUPPORTED\_FRAMERATE | nSamplesPerSec doit être compris entre 1 kHz et 200 kHz. |
| XWMA\_E\_UNSUPPORTED\_CHANNELS | nChannels doit être 1, 2 ou 6. |
| XWMA\_E\_UNSUPPORTED\_BITSPERSAMPLE | wBitsPerSample doit être 8, 16 ou 24 pour les données d'entrée entières, ou 32 pour les données à virgule flottante. |
| XWMA\_E\_UNSUPPORTED\_BITRATE | Le débit binaire doit être de 20 Kbps, 32 Kbps, 48 Kbps, 64 Kbps, 96 Kbps, 16 Kbps0 ou 192 Kbps. |

<a id="remarks" />

## Remarques

Le tableau suivant présente les débits binaires pris en charge de façon native selon la fréquence d'échantillonnage et le nombre de canaux.

\| Entrée| Options de sortie|
\| --- | --- | --- | --- |
\| 22050 Hz mono| 20000|
\| 22050 Hz stéréo| 32000|
\| 32000 Hz mono| 20000|
\| 32000 Hz stéréo| 32000, 48000|
\| 44100 Hz mono| 32000, 48000|
\| 44100 Hz stéréo| 32000, 48000, 96000, 192000|
\| 44100 Hz 5.1| 96000, 192000|
\| 48000 Hz stéréo| 48000, 64000, 96000, 160000, 192000|
\| 48000 Hz 5.1| 48000, 192000|

<a id="requirements" />

## Configuration requise

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

**Bibliothèque :** xwmaencoder.lib

## Voir aussi

[Encodeur xWMA en ligne de commande](/fr-CA/build/console-features/audio/tools/xwmaencode-tools)


## Related topics

- [Fonctions de xwmaencoder](/fr-CA/build/console-features/audio/tools/xwmaencoder/tech-xwmaencoder-nativereference-funcs.md)
- [Vue d'ensemble de xWMA](/fr-CA/build/console-features/audio/overviews/xwma-overview.md)
- [Renseignements de référence sur l'encodeur xWMA](/fr-CA/build/console-features/audio/tools/xwmaencoder/atoc-xwmaencoder.md)
- [Bibliothèque et outil en ligne de commande d'encodage xWMA](/fr-CA/build/console-features/audio/tools/xwmaencoder/index.md)
- [Bibliothèque et outil en ligne de commande d'encodage XMA2](/fr-CA/build/console-features/audio/tools/xma2encoder/index.md)