> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# game_chat_audio_format

> game_chat_audio_format

# game\_chat\_audio\_format

Descreve as informações de formato necessárias para interpretar os dados de áudio do Game Chat 2.

## Sintaxe

```cpp theme={null}
typedef struct game_chat_audio_format {  
    uint32_t sample_rate;  
    uint32_t channel_mask;  
    uint16_t channel_count;  
    uint16_t bits_per_sample;  
    game_chat_sample_type sample_type;  
    bool is_interleaved;  
} game_chat_audio_format  
```

### Membros

*sample\_rate*  \
Tipo: uint32\_t

A frequência de amostragem na qual cada canal deve ser reproduzido ou gravado.

*channel\_mask*  \
Tipo: uint32\_t

A máscara de canal com a qual substituir a atribuição de canais de um fluxo de áudio multicanal às posições dos alto-falantes. Para o mapeamento de bits para alto-falantes desse valor, confira a descrição do membro *dwChannelMask* da estrutura [WAVEFORMATEXTENSIBLE](https://learn.microsoft.com/windows-hardware/drivers/ddi/ksmedia/ns-ksmedia-waveformatextensible) no [Microsoft Docs](https://docs.xbox.com/pt-BR.md). Para usar o mapeamento padrão, defina esse valor como 0.

*channel\_count*  \
Tipo: uint16\_t

O número de canais de dados de áudio.

*bits\_per\_sample*  \
Tipo: uint16\_t

O número de bits por amostra. Se esse valor não for divisível em bytes, presume-se que o tipo de amostra que o contém seja preenchido com bits para torná-lo divisível em bytes.

*sample\_type*  \
Tipo: [game\_chat\_sample\_type](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/enums/game_chat_sample_type.md)

Especifica se o Game Chat 2 está usando dados PCM (Pulse Code Manipulation) representados por inteiros ([game\_chat\_sample\_type::integer](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/enums/game_chat_sample_type.md)) ou por números de ponto flutuante ([game\_chat\_sample\_type::ieee\_float](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/enums/game_chat_sample_type.md)).

*is\_interleaved*  \
Tipo: bool

Um sinalizador que indica se o fluxo de áudio multicanal é intercalado para formatos multicanal.

O áudio recuperado do Game Chat 2 é sempre marcado como intercalado. Esse parâmetro só tem significado se [game\_chat\_audio\_format::channel\_count](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/structs/game_chat_audio_format.md) for maior que 1.

## Comentários

Essa estrutura é usada para descrever o formato dos dados de áudio para fluxos de áudio de pré-codificação, fluxos de origem de áudio de pós-decodificação e fluxos de coletor de áudio de pós-decodificação no Game Chat 2. As funções a seguir obtêm ou definem o `game_chat_audio_format` usado pelos objetos de fluxo correspondentes:

* [pre\_encode\_audio\_stream::get\_pre\_processed\_format](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/pre_encode_audio_stream/methods/pre_encode_audio_stream_get_pre_processed_format.md)
* [pre\_encode\_audio\_stream::set\_processed\_format](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/pre_encode_audio_stream/methods/pre_encode_audio_stream_set_processed_format.md)
* [post\_decode\_audio\_source\_stream::get\_pre\_processed\_format](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/post_decode_audio_source_stream/methods/post_decode_audio_source_stream_get_pre_processed_format.md)
* [post\_decode\_audio\_sink\_stream::set\_processed\_format](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/post_decode_audio_sink_stream/methods/post_decode_audio_sink_stream_set_processed_format.md)

Para obter mais informações sobre formatos de áudio, confira [Manipulação de áudio em tempo real](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/chat/game-chat2/real-time-audio-manipulation.md).

## Requisitos

**Cabeçalho:** GameChat2.h

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

## Confira também

[Introdução ao Game Chat 2](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/chat/game-chat2/game-chat-2-intro.md)\
[chat\_manager](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/chat_manager/chat_manager.md)\
[pre\_encode\_audio\_stream](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/pre_encode_audio_stream/pre_encode_audio_stream.md)\
[post\_decode\_audio\_sink\_stream](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/post_decode_audio_sink_stream/post_decode_audio_sink_stream.md)\
[post\_decode\_audio\_source\_stream](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/post_decode_audio_source_stream/post_decode_audio_source_stream.md)\
[Membros do GameChat2](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/gamechat2_members.md)


## Related topics

- [game_chat_sample_type](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/enums/game_chat_sample_type.md)
- [post_decode_audio_sink_stream::set_processed_format](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/post_decode_audio_sink_stream/methods/post_decode_audio_sink_stream_set_processed_format.md)
- [pre_encode_audio_stream::get_pre_processed_format](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/pre_encode_audio_stream/methods/pre_encode_audio_stream_get_pre_processed_format.md)
- [post_decode_audio_source_stream::get_pre_processed_format](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/post_decode_audio_source_stream/methods/post_decode_audio_source_stream_get_pre_processed_format.md)
- [pre_encode_audio_stream::set_processed_format](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/pre_encode_audio_stream/methods/pre_encode_audio_stream_set_processed_format.md)