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

採用 big-endian 位元組順序的舊版 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](/zh-TW/reference/audio/xma2defs/structs/xma2streamformat)\[1]

個別串流的格式資訊；實際的陣列長度位於 NumStreams 欄位中。

## 備註

<Note>這是舊版 XMA 格式結構。所提供的資訊僅供參考，不應用於新內容。</Note>

`XMAWAVEFORMAT` 是 XMA 第 1 版檔案中使用的結構。`XMA2WAVEFORMAT` 用於早期的 XMA2 檔案。它不是放在一般的 *fmt* RIFF 區塊中，而是放在其自己的 XMA2 區塊中。如需 XMA2 的詳細資訊，請參閱 [XMA2 概觀](/zh-TW/build/console-features/audio/overviews/xma2-overview)。如需 XBOX One 音訊架構的概觀，請參閱*未來之聲*：[XBOX One 的音訊架構](/zh-TW/build/console-features/audio/overviews/xbox-one-audio-architecture)。

## 需求

**標頭：** xma2defs.h

**支援的平台：** XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[xma2defs](/zh-TW/reference/audio/xma2defs/xma2defs_members)


## Related topics

- [XMA2WAVEFORMAT](/reference/audio/xma2defs/structs/xma2waveformat.md)
- [XMA2WAVEFORMATEX](/reference/audio/xma2defs/structs/xma2waveformatex.md)