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

# XMA2STREAMFORMAT

> XMA2STREAMFORMAT

# XMA2STREAMFORMAT

스트림별 데이터를 위해 XMA2WAVEFORMAT에서 사용됩니다.

## 구문

```cpp theme={null}
typedef struct XMA2STREAMFORMAT {  
    BYTE Channels;  
    BYTE RESERVED;  
    WORD ChannelMask;  
} XMA2STREAMFORMAT  
```

### 멤버

*Channels*\
형식: BYTE

스트림의 채널 수(1 또는 2)입니다.

*RESERVED*\
형식: BYTE

예약되어 있습니다.

*ChannelMask*\
형식: WORD

스트림 내 채널의 공간 위치입니다.

최하위 비트는 전면 왼쪽 스피커에 해당하고, 다음 최하위 비트는 전면 오른쪽 스피커에 해당하는 식입니다. 유효성 순서에 따라 비트는 다음과 같이 정의됩니다.

| 스피커 위치                            | 플래그 비트                                   |
| --------------------------------- | ---------------------------------------- |
| SPEAKER\_FRONT\_LEFT              | 0x1                                      |
| SPEAKER\_FRONT\_RIGHT             | 0x2                                      |
| SPEAKER\_FRONT\_CENTER            | 0x4                                      |
| SPEAKER\_LOW\_FREQUENCY           | 0x8                                      |
| SPEAKER\_BACK\_LEFT               | 0x10                                     |
| SPEAKER\_BACK\_RIGHT              | 0x20                                     |
| SPEAKER\_FRONT\_LEFT\_OF\_CENTER  | 0x40                                     |
| SPEAKER\_FRONT\_RIGHT\_OF\_CENTER | 0x80                                     |
| SPEAKER\_BACK\_CENTER             | 0x100                                    |
| SPEAKER\_SIDE\_LEFT               | 0x200                                    |
| SPEAKER\_SIDE\_RIGHT              | 0x400                                    |
| SPEAKER\_TOP\_CENTER              | 0x800                                    |
| SPEAKER\_TOP\_FRONT\_LEFT         | 0x1000                                   |
| SPEAKER\_TOP\_FRONT\_CENTER       | 0x2000                                   |
| SPEAKER\_TOP\_FRONT\_RIGHT        | 0x4000                                   |
| SPEAKER\_TOP\_BACK\_LEFT          | 0x8000                                   |
| SPEAKER\_TOP\_BACK\_CENTER        | 0x10000                                  |
| SPEAKER\_TOP\_BACK\_RIGHT         | 0x20000                                  |
| SPEAKER\_ALL                      | 0x80000000(스피커 구성의 가능한 모든 순열을 지정하는 데 사용) |

다음 스피커 구성이 정의되어 있습니다.

| 스피커 구성                              | 설정된 플래그 비트                                                                                                                                                                                                                         |
| ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| KSAUDIO\_SPEAKER\_MONO              | (SPEAKER\_FRONT\_CENTER)                                                                                                                                                                                                           |
| KSAUDIO\_SPEAKER\_STEREO            | (SPEAKER\_FRONT\_LEFT \| SPEAKER\_FRONT\_RIGHT)                                                                                                                                                                                    |
| KSAUDIO\_SPEAKER\_QUAD              | (SPEAKER\_FRONT\_LEFT \| SPEAKER\_FRONT\_RIGHT \| \ SPEAKER\_BACK\_LEFT \| SPEAKER\_BACK\_RIGHT)                                                                                                                                   |
| KSAUDIO\_SPEAKER\_SURROUND          | (SPEAKER\_FRONT\_LEFT \| SPEAKER\_FRONT\_RIGHT \| \ SPEAKER\_FRONT\_CENTER \| SPEAKER\_BACK\_CENTER)                                                                                                                               |
| KSAUDIO\_SPEAKER\_5POINT1           | (SPEAKER\_FRONT\_LEFT \| SPEAKER\_FRONT\_RIGHT \| \ SPEAKER\_FRONT\_CENTER \| SPEAKER\_LOW\_FREQUENCY \| \ SPEAKER\_BACK\_LEFT \| SPEAKER\_BACK\_RIGHT)                                                                            |
| KSAUDIO\_SPEAKER\_7POINT1           | (SPEAKER\_FRONT\_LEFT \| SPEAKER\_FRONT\_RIGHT \| \ SPEAKER\_FRONT\_CENTER \| SPEAKER\_LOW\_FREQUENCY \| \ SPEAKER\_BACK\_LEFT \| SPEAKER\_BACK\_RIGHT \| \ SPEAKER\_FRONT\_LEFT\_OF\_CENTER \| SPEAKER\_FRONT\_RIGHT\_OF\_CENTER) |
| KSAUDIO\_SPEAKER\_5POINT1\_SURROUND | (SPEAKER\_FRONT\_LEFT \| SPEAKER\_FRONT\_RIGHT \| \ SPEAKER\_FRONT\_CENTER \| SPEAKER\_LOW\_FREQUENCY \| \ SPEAKER\_SIDE\_LEFT \| SPEAKER\_SIDE\_RIGHT)                                                                            |
| KSAUDIO\_SPEAKER\_7POINT1\_SURROUND | (SPEAKER\_FRONT\_LEFT \| SPEAKER\_FRONT\_RIGHT \| \ SPEAKER\_FRONT\_CENTER \| SPEAKER\_LOW\_FREQUENCY \| \ SPEAKER\_BACK\_LEFT \| SPEAKER\_BACK\_RIGHT \| \ SPEAKER\_SIDE\_LEFT \| SPEAKER\_SIDE\_RIGHT)                           |

다음 DVD 스피커 위치가 정의되어 있습니다.

| 스피커 위치                                  | 플래그 비트                  |
| --------------------------------------- | ----------------------- |
| KSAUDIO\_SPEAKER\_GROUND\_FRONT\_LEFT   | SPEAKER\_FRONT\_LEFT    |
| KSAUDIO\_SPEAKER\_GROUND\_FRONT\_CENTER | SPEAKER\_FRONT\_CENTER  |
| KSAUDIO\_SPEAKER\_GROUND\_FRONT\_RIGHT  | SPEAKER\_FRONT\_RIGHT   |
| KSAUDIO\_SPEAKER\_GROUND\_REAR\_LEFT    | SPEAKER\_BACK\_LEFT     |
| KSAUDIO\_SPEAKER\_GROUND\_REAR\_RIGHT   | SPEAKER\_BACK\_RIGHT    |
| KSAUDIO\_SPEAKER\_TOP\_MIDDLE           | SPEAKER\_TOP\_CENTER    |
| KSAUDIO\_SPEAKER\_SUPER\_WOOFER         | SPEAKER\_LOW\_FREQUENCY |

## 설명

이 구조체는 스트림별 데이터를 위해 `XMA2WAVEFORMAT`에서 사용됩니다. 아래 코드 예제에서와 같이 `Channels`는 스트림의 채널 수를 나타냅니다. `ChannelMask`는 스트림 내 채널의 공간 위치를 나타냅니다.

```cpp theme={null}
typedef struct XMA2STREAMFORMAT
{
    BYTE Channels;           // Number of channels in the stream (1 or 2)
    BYTE RESERVED;           // Reserved for future use
    WORD ChannelMask;        // Spatial positions of the channels in the stream
} XMA2STREAMFORMAT;

```

XMA2에 대한 자세한 내용은 [XMA2 개요](/build/console-features/audio/overviews/xma2-overview)를 참조하세요. XBOX One의 오디오 아키텍처 개요는 **The sound of the future**: [The audio architecture in 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

- [XMA2Defs](/ko/reference/audio/xma2defs/xma2defs_members.md)
- [XMA2WAVEFORMAT](/ko/reference/audio/xma2defs/structs/xma2waveformat.md)
- [XMA2WAVEFORMATEX](/ko/reference/audio/xma2defs/structs/xma2waveformatex.md)
- [XMA2PACKET](/ko/reference/audio/xma2defs/structs/xma2packet.md)
- [XMA2 개요](/ko/build/console-features/audio/overviews/xma2-overview.md)