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

# XMA2WAVEFORMAT

> XMA2WAVEFORMAT

# XMA2WAVEFORMAT

采用大端字节序的旧版 XMA2 格式结构。

## 语法

```cpp theme={null}
typedef struct XMA2WAVEFORMAT {  
    BYTE Version;  
    BYTE NumStreams;  
    BYTE RESERVED;  
    BYTE LoopCount;  
    DWORD LoopBegin;  
    DWORD LoopEnd;  
    DWORD SampleRate;  
    DWORD EncodeOptions;  
    DWORD PsuedoBytesPerSec;  
    DWORD BlockSizeInBytes;  
    DWORD SamplesEncoded;  
    DWORD SamplesInSource;  
    DWORD BlockCount;  
    XMA2STREAMFORMAT Streams[1];  
} XMA2WAVEFORMAT  
```

### 成员

*Version*\
类型：BYTE

生成该文件的 XMA 编码器的版本。对于 XMA2 文件，始终为 3 或更高版本。

*NumStreams*\
类型：BYTE

交错音频流的数量。

*RESERVED*\
类型：BYTE

保留。

*LoopCount*\
类型：BYTE

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

*LoopBegin*\
类型：DWORD

循环起点（以采样为单位）。

*LoopEnd*\
类型：DWORD

循环终点（以采样为单位）。

*SampleRate*\
类型：DWORD

文件的已解码采样率。

*EncodeOptions*\
类型：DWORD

XMA 编码器或解码器的选项。

*PsuedoBytesPerSec*\
类型：DWORD

供 XMA 编码器内部使用。

*BlockSizeInBytes*\
类型：DWORD

此文件的 XMA 块的大小（以字节为单位），最后一个块可能除外。始终为 2 KB 的倍数，因为 XMA 块是 2 KB 数据包的数组。

*SamplesEncoded*\
类型：DWORD

此文件中编码的 PCM 采样总数。

*SamplesInSource*\
类型：DWORD

用于生成此文件的源材料中的实际 PCM 采样数量。

*BlockCount*\
类型：DWORD

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

*Streams*\
类型：[XMA2STREAMFORMAT](/reference/audio/xma2defs/structs/xma2streamformat)\[1]

按流的格式信息；实际数组长度位于 NumStreams 字段中。

## 备注

<Note>这是旧版 XMA 格式结构。所提供的信息应仅供参考，不应在新内容中使用。</Note>

`XMAWAVEFORMAT` 是 XMA 第 1 版文件中使用的结构。`XMA2WAVEFORMAT` 用于早期的 XMA2 文件。它不放在常规的 *fmt* RIFF 块中，而是放在自己的 XMA2 块中。有关 XMA2 的详细信息，请参阅 [XMA2 概述](/build/console-features/audio/overviews/xma2-overview)。有关 XBOX One 音频架构的概述，请参阅 *未来之声*：[XBOX One 中的音频架构](/build/console-features/audio/overviews/xbox-one-audio-architecture)。

## 要求

**头文件：** xma2defs.h

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

## 另请参阅

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


## Related topics

- [XMA2WAVEFORMATEX](/zh-CN/reference/audio/xma2defs/structs/xma2waveformatex.md)
- [XMA2STREAMFORMAT](/zh-CN/reference/audio/xma2defs/structs/xma2streamformat.md)
- [XMA2Defs](/zh-CN/reference/audio/xma2defs/xma2defs_members.md)
- [XMASTREAMFORMAT](/zh-CN/reference/audio/xma2defs/structs/xmastreamformat.md)
- [XMAWAVEFORMAT](/zh-CN/reference/audio/xma2defs/structs/xmawaveformat.md)