> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XAudio2XMAEncoder

> XAudio2XMAEncoder

Codifica las secuencias de entrada al formato XMA.

## Sintaxis

```cpp theme={null}
HRESULT XAudio2XMAEncoder(
         DWORD InputStreamCount,
         const XMAENCODERSTREAM *pStreams,
         DWORD Compression,
         DWORD Flags,
         DWORD BlockSizeInKbytes,
         VOID **ppEncodedBuffer,
         DWORD *pEncodedBufferSize,
         XMA2WAVEFORMATEX **ppEncodedBufferFormat,
         DWORD *pEncodedBufferFormatSize,
         DWORD **ppSeekTable,
         DWORD *pSeekTableSize)  
```

### Parámetros

*InputStreamCount*
Tipo: DWORD

Número de secuencias de entrada.

*pStreams*
Tipo: XMAENCODERSTREAM \*

Puntero a las secuencias de entrada.

*Compression*
Tipo: DWORD

Nivel de calidad de compresión XMA2 que se va a usar (de 1 a 100).

*Flags*
Tipo: DWORD

Cero, o una o más de las marcas siguientes.

| Marca | Valor | Descripción |
| - | - | - |
| XMAENCODER\_LOOP | 0x00000001 | Usa los puntos de bucle si están presentes y vuelve a muestrear la onda para que los puntos de bucle se alineen con límites de 128 muestras. Si no hay puntos de bucle presentes, reproduce la onda en bucle de principio a fin y la vuelve a muestrear para que el final del bucle \[longitud completa] de la onda se alinee con un límite de 128 muestras. |
| XMAENCODER\_NOFILTER | 0x00000002 | No establece ningún filtrado. |
| XMAENCODER\_DECODEFROMXMA | 0x00000004 | No compatible con el codificador en memoria. |
| XMAENCODER\_VERBOSE | 0x00000008 | Habilita la salida de depuración. |
| XMAENCODER\_PACKSTREAMS | 0x00000010 | Empaqueta los canales en el menor número de secuencias posible. |

*BlockSizeInKbytes*
Tipo: DWORD

Tamaño de bloque de compresión XMA2 que se va a usar, en KB (de 2 a 8190). No puede ser cero.

*ppEncodedBuffer*
Tipo: VOID \*\*

Puntero a un puntero al búfer que contendrá los datos codificados.

*pEncodedBufferSize*
Tipo: DWORD \*

Puntero a un DWORD que contendrá el tamaño del búfer codificado.

*ppEncodedBufferFormat*
Tipo: XMA2WAVEFORMATEX \*\*

Puntero a un puntero a una estructura que contendrá los detalles de formato de las secuencias codificadas.

*pEncodedBufferFormatSize*
Tipo: DWORD \*

Puntero a un DWORD que contendrá el tamaño de la estructura de formato.

*ppSeekTable*
Tipo: DWORD \*\*

Puntero a un puntero que contendrá la tabla de búsqueda.

*pSeekTableSize*
Tipo: DWORD \*

Puntero a un DWORD que contendrá el tamaño de la tabla de búsqueda.

### 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 | Implementación | Descripción |
| - | - | - |
| XMAENCODER\_E\_OUTOFMEMORY | E\_OUTOFMEMORY | Memoria insuficiente. |
| XMAENCODER\_E\_INVALIDARG | E\_INVALIDARG | Argumento no válido. |
| XMAENCODER\_E\_NOTIMPL | E\_NOTIMPL | No implementado. |
| XMAENCODER\_E\_FAIL | E\_FAIL | Error desconocido. |
| XMAENCODER\_E\_INVALIDLOOP | XMAENCODERERROR(0x001) | Los puntos de bucle no son válidos. |
| XMAENCODER\_E\_UNSUPPORTEDFORMAT | XMAENCODERERROR(0x002) | El formato no es válido. |
| XMAENCODER\_E\_OUTOFRANGE | XMAENCODERERROR(0x003) | El parámetro está fuera del intervalo válido. |
| XMAENCODER\_E\_READFAILED | XMAENCODERERROR(0x004) | Error en la operación de lectura. |
| XMAENCODER\_E\_INVALIDFRAME | XMAENCODERERROR(0x005) | Trama XMA no válida. |
| XMAENCODER\_E\_INCOMPLETEFRAME | XMAENCODERERROR(0x006) | Trama XMA incompleta. |
| XMAENCODER\_E\_ZEROSTUFFINGBIT | XMAENCODERERROR(0x007) | El bit de relleno es cero. |
| XMAENCODER\_E\_GETDATAFAILED | XMAENCODERERROR(0x008) | Error al capturar los datos. |

## Requisitos

**Encabezado:** xmaencoder.h

**Biblioteca:** xmaencoder.lib

## Consulte también

[Herramienta de codificación XMA2](https://docs.xbox.com/es/build/console-features/audio/tools/xma2encodertool.md)


## Related topics

- [Información de referencia del codificador XMA2](https://docs.xbox.com/es/build/console-features/audio/tools/xma2encoder/atoc-xmaencoder.md)
- [Funciones de XMA2encoder](https://docs.xbox.com/es/build/console-features/audio/tools/xma2encoder/tech-xmaencoder-funcs.md)
- [Biblioteca y herramienta de línea de comandos del codificador XMA2](https://docs.xbox.com/es/build/console-features/audio/tools/xma2encoder/index.md)
- [Herramienta de codificación XMA2](https://docs.xbox.com/es/build/console-features/audio/tools/xma2encodertool.md)
- [XWMAEncoder](https://docs.xbox.com/es/build/console-features/audio/tools/xwmaencoder/methods/xwmaencoder-xwmaencoder-xbox-microsoft-m.md)