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

表示 XMA2 文件格式信息的推荐方式。

## 语法

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

### 成员

*wfx*\
类型：WAVEFORMATEX

一个 WAVEFORMATEX 结构。

*NumStreams*\
类型：WORD

音频流的数量：每个 1 或 2 通道。

*ChannelMask*\
类型：DWORD

此文件中通道的空间位置。请参阅 XMA\_SPEAKER\* 宏。

*SamplesEncoded*\
类型：DWORD

此文件解码后的 PCM 采样总数。

*BytesPerBlock*\
类型：DWORD

XMA 块的大小。最后一个块可能较短。

*PlayBegin*\
类型：DWORD

已解码音频中的第一个有效采样。

*PlayLength*\
类型：DWORD

已解码音频的有效部分的长度。

*LoopBegin*\
类型：DWORD

以已解码采样为单位的循环起点。

*LoopLength*\
类型：DWORD

以已解码采样为单位的循环长度。

*LoopCount*\
类型：BYTE

循环重复次数；255 = 无限。

*EncoderVersion*\
类型：BYTE

生成该文件的 XMA 编码器的版本。

*BlockCount*\
类型：WORD

文件中的 XMA 块数，也是其查找表中的条目数。

## 备注

此结构完全符合 *WAVEFORMATEX* 标准，并以紧凑方式包含解析和管理 *XMA2* 文件所需的所有信息。

XMA2 格式与 XBOX 360 兼容，XBOX One 需要按 ULONG 字节交换查找表。如果输入是 *WAVE* 文件，则可以直接使用输出，无需修改。若要按字节交换查找表，可使用以下代码。

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

可以考虑向你的应用添加代码来测试此功能，然后另外编写一个工具进行交换，以便你的应用无需进行预处理。

## 要求

**头文件：** xma2defs.h

**支持的平台：** XBOX One 系列主机和 XBOX Series 主机

## 概念文档

* [XMA2 概述](/build/console-features/audio/overviews/xma2-overview)

## 另请参阅

[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

- [XMA2 概述](/zh-CN/build/console-features/audio/overviews/xma2-overview.md)
- [XMA2Defs](/zh-CN/reference/audio/xma2defs/xma2defs_members.md)
- [LocalizeXma2Format](/zh-CN/reference/audio/xma2defs/functions/localizexma2format.md)
- [XAudio2XMAEncoder](/zh-CN/build/console-features/audio/tools/xma2encoder/methods/xaudio2xmaencoder-xmaencoder-xbox-microsoft-m.md)
- [XMA2WAVEFORMAT](/zh-CN/reference/audio/xma2defs/structs/xma2waveformat.md)