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

Usada em XMA2WAVEFORMAT para dados por fluxo.

## Sintaxe

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

### Membros

*Channels*\
Tipo: BYTE

Número de canais (1 ou 2) no fluxo.

*RESERVED*\
Tipo: BYTE

Reservado.

*ChannelMask*\
Tipo: WORD

Posições espaciais dos canais no fluxo.

O bit menos significativo corresponde ao alto-falante frontal esquerdo, o próximo bit menos significativo corresponde ao alto-falante frontal direito e assim por diante. Os bits, em ordem de significância, são definidos da seguinte maneira.

| Posição do alto-falante | Bit de sinalizador |
| - | - |
| 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 (usado para especificar qualquer permutação possível de configurações de alto-falantes) |

As seguintes configurações de alto-falantes são definidas.

| Configuração de alto-falantes | Bits de sinalizador definidos |
| - | - |
| 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) |

As seguintes posições de alto-falantes de DVD são definidas.

| Posição do alto-falante | Bit de sinalizador |
| - | - |
| 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 |

## Comentários

Essa estrutura é usada em `XMA2WAVEFORMAT` para dados por fluxo. Conforme mostrado no exemplo de código abaixo, `Channels` se refere ao número de canais no fluxo. `ChannelMask` se refere às posições espaciais dos canais no fluxo.

```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;

```

Para obter mais informações sobre o XMA2, consulte [Visão geral do XMA2](/pt-BR/build/console-features/audio/overviews/xma2-overview). Para obter uma visão geral da arquitetura de áudio do XBOX One, consulte **O som do futuro**: [A arquitetura de áudio no XBOX One](/pt-BR/build/console-features/audio/overviews/xbox-one-audio-architecture).

## Requisitos

**Cabeçalho:** xma2defs.h

**Plataformas com suporte:** consoles da família XBOX One e consoles XBOX Series

## Confira também

[xma2defs](/pt-BR/reference/audio/xma2defs/xma2defs_members)


## Related topics

- [XMA2Defs](/pt-BR/reference/audio/xma2defs/xma2defs_members.md)
- [XMA2WAVEFORMAT](/pt-BR/reference/audio/xma2defs/structs/xma2waveformat.md)
- [XMA2WAVEFORMATEX](/pt-BR/reference/audio/xma2defs/structs/xma2waveformatex.md)
- [XMA2PACKET](/pt-BR/reference/audio/xma2defs/structs/xma2packet.md)
- [Visão geral do XMA2](/pt-BR/build/console-features/audio/overviews/xma2-overview.md)