> ## 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 の概要](/ja-jp/build/console-features/audio/overviews/xma2-overview.md)
- [LocalizeXma2Format](/ja-jp/reference/audio/xma2defs/functions/localizexma2format.md)
- [XMA2Defs](/ja-jp/reference/audio/xma2defs/xma2defs_members.md)
- [XAudio2XMAEncoder](/ja-jp/build/console-features/audio/tools/xma2encoder/methods/xaudio2xmaencoder-xmaencoder-xbox-microsoft-m.md)
- [XMA2PACKET](/ja-jp/reference/audio/xma2defs/structs/xma2packet.md)