> ## 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 概觀](/zh-TW/build/console-features/audio/overviews/xma2-overview)

## 另請參閱

[XMA2 概觀](/zh-TW/build/console-features/audio/overviews/xma2-overview)

[XMA2WAVEFORMAT](/zh-TW/reference/audio/xma2defs/structs/xma2waveformat)

[XMA2WAVEFORMATEX](/zh-TW/reference/audio/xma2defs/structs/xma2waveformatex)

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


## Related topics

- [XMA2WAVEFORMATEX](/reference/audio/xma2defs/structs/xma2waveformatex.md)
- [Overview of XMA2](/build/console-features/audio/overviews/xma2-overview.md)
- [XMA2 概述](/zh-CN/build/console-features/audio/overviews/xma2-overview.md)
- [XMA2 개요](/ko/build/console-features/audio/overviews/xma2-overview.md)
- [XMA2Defs](/reference/audio/xma2defs/xma2defs_members.md)