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

# game_chat_text_chat_received_state_change

> game_chat_text_chat_received_state_change

# game\_chat\_text\_chat\_received\_state\_change

Representa informações específicas da alteração de estado [game\_chat\_state\_change\_type::text\_chat\_received](/pt-BR/reference/chat/gamechat2/enums/game_chat_state_change_type).

<a id="syntaxSection" />

## Sintaxe

```cpp theme={null}
typedef struct game_chat_text_chat_received_state_change {  
    chat_user* sender;  
    uint32_t receiver_count;  
    chat_user_array receivers;  
    PCWSTR message;  
} game_chat_text_chat_received_state_change  
```

<a id="membersSection" />

### Membros

*sender*  \
Tipo: [chat\_user](/pt-BR/reference/chat/gamechat2/classes/chat_user/chat_user)\*

Um ponteiro para o objeto `chat_user` que originou a mensagem de texto.

Os ponteiros para objetos `chat_user` permanecem válidos até que o usuário seja removido da instância local de [chat\_manager](/pt-BR/reference/chat/gamechat2/classes/chat_manager/chat_manager) por meio do método [chat\_manager::remove\_user](/pt-BR/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_remove_user).

*receiver\_count*  \
Tipo: uint32\_t

O número de elementos da matriz em *receivers*.

*receivers*  \_Field\_size\_(receiver\_count)\
Tipo: [chat\_user\_array](/pt-BR/reference/chat/gamechat2/classes/chat_user/chat_user#array)

Uma matriz de ponteiros `chat_user` para um ou mais jogadores locais de destino aos quais a mensagem de texto é endereçada.

A memória do objeto `chat_user_array` permanece válida até que esse objeto seja retornado chamando  [chat\_manager::finish\_processing\_state\_changes](/pt-BR/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_finish_processing_state_changes). Os ponteiros individuais de objetos `chat_user` permanecem válidos até que o usuário seja removido da instância local de `chat_manager` por meio do método `chat_manager::remove_user`.

*message*  \
Tipo: PCWSTR

Um ponteiro para a cadeia de caracteres de texto que foi enviada chamando [chat\_user\_local::send\_chat\_text](/pt-BR/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_send_chat_text). A cadeia de caracteres pode ter até `c_maxChatTextMessageLength` caracteres, sem incluir o terminador nulo.

<Note>`c_maxChatTextMessageLength` é um `constexpr uint16_t` com o valor 1023.</Note>

A cadeia de caracteres permanece válida até que esse objeto seja retornado chamando `chat_manager::finish_processing_state_changes`. O aplicativo deve fazer uma cópia do texto para exibi-lo da maneira e pela duração descritas no documento do guia de políticas de comunicação do Game Chat.

<a id="remarksSection" />

## Comentários

Essa estrutura fornece informações adicionais para uma alteração de estado [game\_chat\_state\_change\_type::text\_chat\_received](/pt-BR/reference/chat/gamechat2/enums/game_chat_state_change_type) no Game Chat 2. Essa alteração de estado ocorre quando chega uma comunicação de texto entre jogadores.

Se essa alteração de estado ocorrer, essa estrutura será retornada como um elemento [game\_chat\_state\_change](/pt-BR/reference/chat/gamechat2/structs/game_chat_state_change) na matriz [game\_chat\_state\_change\_array](/pt-BR/reference/chat/gamechat2/structs/game_chat_state_change#array) recuperada quando [chat\_manager::start\_processing\_state\_changes](/pt-BR/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_start_processing_state_changes) for chamado pelo seu aplicativo. Depois de confirmar o tipo de alteração de estado verificando o valor do membro `state_change_type` desse elemento `game_chat_state_change`, você poderá converter esse elemento nessa estrutura. Em seguida, você poderá usar essa estrutura para obter mais informações sobre a alteração de estado e processá-la antes que a matriz seja devolvida ao Game Chat 2 pelo seu aplicativo, chamando [chat\_manager::finish\_processing\_state\_changes](/pt-BR/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_finish_processing_state_changes).

Para obter mais informações sobre o processamento de alterações de estado, confira [Usando a API C++ do Game Chat 2](/pt-BR/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2).

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** GameChat2.h

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

<a id="seealsoSection" />

## Documentação conceitual

* [Usando a API C++ do Game Chat 2](/pt-BR/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2)

## Confira também

[Introdução ao Game Chat 2](/pt-BR/services/xbox-services/multiplayer/chat/game-chat2/game-chat-2-intro)\
[chat\_manager](/pt-BR/reference/chat/gamechat2/classes/chat_manager/chat_manager)\
[Membros do GameChat2](/pt-BR/reference/chat/gamechat2/gamechat2_members)


## Related topics

- [game_chat_text_chat_received_state_change](/reference/chat/gamechat2/structs/game_chat_text_chat_received_state_change.md)
- [game_chat_state_change](/reference/chat/gamechat2/structs/game_chat_state_change.md)
- [game_chat_state_change_type](/reference/chat/gamechat2/enums/game_chat_state_change_type.md)