> ## 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 音频架构的概述，请参阅**未来之声**：[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](/zh-CN/reference/audio/xma2defs/xma2defs_members.md)
- [XMA2WAVEFORMAT](/zh-CN/reference/audio/xma2defs/structs/xma2waveformat.md)
- [XMA2WAVEFORMATEX](/zh-CN/reference/audio/xma2defs/structs/xma2waveformatex.md)
- [XMA2PACKET](/zh-CN/reference/audio/xma2defs/structs/xma2packet.md)
- [XMA2 概述](/zh-CN/build/console-features/audio/overviews/xma2-overview.md)