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

# XAudio2XMAEncoder

> XAudio2XMAEncoder

Codifica las secuencias de entrada al formato XMA.

<a id="syntaxSection" />

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

<a id="ID4EG" />

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

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

<a id="requirements" />

## Requisitos

**Encabezado:** xmaencoder.h

**Biblioteca:** xmaencoder.lib

## Consulte también

[Herramienta de codificación XMA2](/build/console-features/audio/tools/xma2encodertool)


## Related topics

- [Funciones de XMA2encoder](/es/build/console-features/audio/tools/xma2encoder/tech-xmaencoder-funcs.md)
- [Información de referencia del codificador XMA2](/es/build/console-features/audio/tools/xma2encoder/atoc-xmaencoder.md)
- [Herramienta de codificación XMA2](/es/build/console-features/audio/tools/xma2encodertool.md)
- [XWMAEncoder](/es/build/console-features/audio/tools/xwmaencoder/methods/xwmaencoder-xwmaencoder-xbox-microsoft-m.md)
- [XAudio2CreateWithSharedContexts](/es/reference/audio/xaudio2xbox/functions/xaudio2createwithsharedcontexts.md)