> ## 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 概觀](/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

- [XMA2STREAMFORMAT](/reference/audio/xma2defs/structs/xma2streamformat.md)
- [XMA2Defs](/reference/audio/xma2defs/xma2defs_members.md)
- [XMA2WAVEFORMAT](/reference/audio/xma2defs/structs/xma2waveformat.md)