> ## 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*\
\u0001\u0001\u0001형식: 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 개요](/ko/build/console-features/audio/overviews/xma2-overview.md)
- [LocalizeXma2Format](/ko/reference/audio/xma2defs/functions/localizexma2format.md)
- [XMA2Defs](/ko/reference/audio/xma2defs/xma2defs_members.md)
- [XAudio2XMAEncoder](/ko/build/console-features/audio/tools/xma2encoder/methods/xaudio2xmaencoder-xmaencoder-xbox-microsoft-m.md)
- [XMA2PACKET](/ko/reference/audio/xma2defs/structs/xma2packet.md)