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

# XMA2WAVEFORMATEX

> XMA2WAVEFORMATEX

# XMA2WAVEFORMATEX

La manera recomendada de expresar la información de formato de los archivos XMA2.

## Sintaxis

```cpp theme={null}
typedef struct XMA2WAVEFORMATEX {  
    WAVEFORMATEX wfx;  
    WORD NumStreams;  
    DWORD ChannelMask;  
    DWORD SamplesEncoded;  
    DWORD BytesPerBlock;  
    DWORD PlayBegin;  
    DWORD PlayLength;  
    DWORD LoopBegin;  
    DWORD LoopLength;  
    BYTE LoopCount;  
    BYTE EncoderVersion;  
    WORD BlockCount;  
} XMA2WAVEFORMATEX  
```

### Miembros

*wfx*\
Tipo: WAVEFORMATEX

Una estructura WAVEFORMATEX.

*NumStreams*\
Tipo: WORD

Número de secuencias de audio: de 1 o 2 canales cada una.

*ChannelMask*\
Tipo: DWORD

Posiciones espaciales de los canales de este archivo. Consulte las macros XMA\_SPEAKER\*.

*SamplesEncoded*\
Tipo: DWORD

Número total de muestras PCM en que se descodifica el archivo.

*BytesPerBlock*\
Tipo: DWORD

Tamaño del bloque de XMA. El último bloque puede ser más corto.

*PlayBegin*\
Tipo: DWORD

Primera muestra válida del audio descodificado.

*PlayLength*\
Tipo: DWORD

Longitud de la parte válida del audio descodificado.

*LoopBegin*\
Tipo: DWORD

Comienzo del bucle en muestras descodificadas.

*LoopLength*\
Tipo: DWORD

Longitud del bucle en muestras descodificadas.

*LoopCount*\
Tipo: BYTE

Número de repeticiones del bucle; 255 = infinito.

*EncoderVersion*\
Tipo: BYTE

Versión del codificador de XMA que generó el archivo.

*BlockCount*\
Tipo: WORD

Número de bloques de XMA de un archivo, que también es el número de entradas de su tabla de búsqueda.

## Comentarios

Esta estructura cumple totalmente con el estándar *WAVEFORMATEX* y contiene toda la información necesaria para analizar y administrar archivos *XMA2* de forma compacta.

El formato XMA2 es compatible con XBOX 360, y en la tabla de búsqueda es necesario intercambiar los bytes de los valores ULONG para XBOX One. Si la entrada es un archivo *WAVE*, la salida se puede usar sin modificaciones. Para intercambiar los bytes de la tabla de búsqueda, use las líneas de código siguientes.

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

Considere la posibilidad de agregar líneas de código a la aplicación para probar la funcionalidad y, después, quizás escribir una herramienta independiente para realizar el intercambio de modo que la aplicación no requiera ningún procesamiento previo.

## Requisitos

**Encabezado:** xma2defs.h

**Plataformas compatibles:** consolas de la familia XBOX One y consolas XBOX Series

## Documentación conceptual

* [Información general de XMA2](/build/console-features/audio/overviews/xma2-overview)

## Consulte también

[Información general de XMA2](/build/console-features/audio/overviews/xma2-overview)

[XMA2WAVEFORMAT](/reference/audio/xma2defs/structs/xma2waveformat)

[XMA2WAVEFORMATEX](/reference/audio/xma2defs/structs/xma2waveformatex)

[xma2defs](/reference/audio/xma2defs/xma2defs_members)


## Related topics

- [XMA2Defs](/es/reference/audio/xma2defs/xma2defs_members.md)
- [Información general de XMA2](/es/build/console-features/audio/overviews/xma2-overview.md)
- [LocalizeXma2Format](/es/reference/audio/xma2defs/functions/localizexma2format.md)
- [XAudio2XMAEncoder](/es/build/console-features/audio/tools/xma2encoder/methods/xaudio2xmaencoder-xmaencoder-xbox-microsoft-m.md)
- [XMA2WAVEFORMAT](/es/reference/audio/xma2defs/structs/xma2waveformat.md)
