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

Codifica un búfer de entrada en datos xWMA.

<a id="syntaxSection" />

## Sintaxis

```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" />

### Parámetros

*pInputBuffer*
Tipo: BYTE \*

Puntero al búfer de entrada que contiene los datos PCM; debe contener al menos una trama.

*inputBufferSize*
Tipo: DWORD

Tamaño del búfer de entrada, en bytes.

*pInputFormat*
Tipo: WAVEFORMATEX \*

Formato del búfer de entrada.

*outputBitrate*
Tipo: DWORD

Especifica la velocidad de bits solicitada; debe ser una de las siguientes: 20000, 32000, 48000, 64000, 96000, 160000 o 192000.

*ppEncodedBuffer*
Tipo: BYTE \*\*

Puntero a un puntero a los datos codificados.

*pEncodedBufferSize*
Tipo: DWORD \*

Puntero a un DWORD que contiene el tamaño de los datos codificados, en bytes.

*ppEncodedBufferFormat*
Tipo: WAVEFORMATEX \*\*

Puntero a un puntero a la estructura de formato de salida.

*pEncodedBufferFormatSize*
Tipo: DWORD \*

Puntero a un DWORD que contiene el tamaño de la estructura de formato de salida.

*ppDecodedPacketCumulativeBytes*
Tipo: DWORD \*\*

Matriz de tamaños acumulados de datos de paquetes descodificados (use free \[] para liberarla). Cada elemento es el número de bytes acumulados cuando el paquete WMA correspondiente se descodifica en orden; debe tener PacketCount elementos. PacketCount se establece en la estructura XAUDIO2\_BUFFER\_WMA.

*pDecodedPacketCumulativeBytesSize*
Tipo: DWORD \*

Tamaño de los datos acumulados de paquetes descodificados (en bytes). El número de paquetes = \*pDecodedPacketCumulativeBytesSize / sizeof(DWORD);

<a id="ID4EO" />

### Valor devuelto

Tipo: HRESULT

Devuelve S\_OK si se realiza correctamente; de lo contrario, devuelve un código de error de la tabla siguiente.

| Código de error                     | Descripción                                                                                          |
| ----------------------------------- | ---------------------------------------------------------------------------------------------------- |
| XWMA\_E\_UNSUPPORTED\_FORMATTAG     | La etiqueta de formato debe ser WAVE\_FORMAT\_PCM o WAVE\_FORMAT\_IEEE\_FLOAT.                       |
| XWMA\_E\_UNSUPPORTED\_FRAMERATE     | nSamplesPerSec debe estar entre 1 kHz y 200 kHz.                                                     |
| XWMA\_E\_UNSUPPORTED\_CHANNELS      | nChannels debe ser 1, 2 o 6.                                                                         |
| XWMA\_E\_UNSUPPORTED\_BITSPERSAMPLE | wBitsPerSample debe ser 8, 16 o 24 para datos de entrada enteros, o 32 para datos de punto flotante. |
| XWMA\_E\_UNSUPPORTED\_BITRATE       | La velocidad de bits debe ser 20 Kbps, 32 Kbps, 48 Kbps, 64 Kbps, 96 Kbps, 16 Kbps0 o 192 Kbps.      |

<a id="remarks" />

## Comentarios

La tabla siguiente muestra las velocidades de bits admitidas de forma nativa por frecuencia de muestreo y número de canales.

\| Entrada| Opciones de salida|
\| --- | --- | --- | --- |
\| 22050 Hz mono| 20000|
\| 22050 Hz estéreo| 32000|
\| 32000 Hz mono| 20000|
\| 32000 Hz estéreo| 32000, 48000|
\| 44100 Hz mono| 32000, 48000|
\| 44100 Hz estéreo| 32000, 48000, 96000, 192000|
\| 44100 Hz 5.1| 96000, 192000|
\| 48000 Hz estéreo| 48000, 64000, 96000, 160000, 192000|
\| 48000 Hz 5.1| 48000, 192000|

<a id="requirements" />

## Requisitos

**Encabezado:** xwmaencoder.h

**Biblioteca:** xwmaencoder.lib

## Consulte también

[Codificador de línea de comandos de xWMA](/build/console-features/audio/tools/xwmaencode-tools)


## Related topics

- [Funciones de Xwmaencoder](/es/build/console-features/audio/tools/xwmaencoder/tech-xwmaencoder-nativereference-funcs.md)
- [Información general de xWMA](/es/build/console-features/audio/overviews/xwma-overview.md)
- [Información de referencia del codificador xWMA](/es/build/console-features/audio/tools/xwmaencoder/atoc-xwmaencoder.md)
- [Biblioteca y herramienta de línea de comandos del codificador xWMA](/es/build/console-features/audio/tools/xwmaencoder/index.md)
- [Biblioteca y herramienta de línea de comandos del codificador XMA2](/es/build/console-features/audio/tools/xma2encoder/index.md)