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

Représente les informations propres au changement d'état [game\_chat\_state\_change\_type::text\_chat\_received](/fr/reference/chat/gamechat2/enums/game_chat_state_change_type).

<a id="syntaxSection" />

## Syntaxe

```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" />

### Membres

*sender*  \
Type : [chat\_user](/fr/reference/chat/gamechat2/classes/chat_user/chat_user)\*

Pointeur vers l'objet `chat_user` à l'origine du message texte.

Les pointeurs vers les objets `chat_user` restent valides jusqu'à ce que l'utilisateur soit supprimé de l'instance [chat\_manager](/fr/reference/chat/gamechat2/classes/chat_manager/chat_manager) locale via la méthode [chat\_manager::remove\_user](/fr/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_remove_user).

*receiver\_count*  \
Type : uint32\_t

Nombre d'éléments du tableau *receivers*.

*receivers*  \_Field\_size\_(receiver\_count)\
Type : [chat\_user\_array](/fr/reference/chat/gamechat2/classes/chat_user/chat_user#array)

Tableau de pointeurs `chat_user` vers un ou plusieurs joueurs locaux destinataires du message texte.

La mémoire de l'objet `chat_user_array` reste valide jusqu'à ce que cet objet ait été renvoyé en appelant [chat\_manager::finish\_processing\_state\_changes](/fr/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_finish_processing_state_changes). Les pointeurs d'objets `chat_user` individuels restent valides jusqu'à ce que l'utilisateur soit supprimé de l'instance `chat_manager` locale via la méthode `chat_manager::remove_user`.

*message*  \
Type : PCWSTR

Pointeur vers la chaîne de texte envoyée en appelant [chat\_user\_local::send\_chat\_text](/fr/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_send_chat_text). La chaîne peut contenir jusqu'à `c_maxChatTextMessageLength` caractères, sans compter le terminateur null.

<Note>`c_maxChatTextMessageLength` est un `constexpr uint16_t` dont la valeur est 1023.</Note>

La chaîne reste valide jusqu'à ce que cet objet ait été renvoyé en appelant `chat_manager::finish_processing_state_changes`. L'application doit faire une copie du texte afin de l'afficher de la manière et pendant la durée décrites dans le guide de stratégie de communication de Game Chat.

<a id="remarksSection" />

## Remarques

Cette structure fournit des informations supplémentaires pour un changement d'état [game\_chat\_state\_change\_type::text\_chat\_received](/fr/reference/chat/gamechat2/enums/game_chat_state_change_type) dans Game Chat 2. Ce changement d'état se produit lorsqu'une communication textuelle entre joueurs est arrivée.

Si ce changement d'état se produit, cette structure est renvoyée en tant qu'élément [game\_chat\_state\_change](/fr/reference/chat/gamechat2/structs/game_chat_state_change) dans le tableau [game\_chat\_state\_change\_array](/fr/reference/chat/gamechat2/structs/game_chat_state_change#array) récupéré lorsque votre application appelle [chat\_manager::start\_processing\_state\_changes](/fr/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_start_processing_state_changes). Après avoir confirmé le type de changement d'état en vérifiant la valeur du membre `state_change_type` de cet élément `game_chat_state_change`, vous pouvez effectuer un cast de cet élément vers cette structure. Vous pouvez ensuite utiliser cette structure pour obtenir plus d'informations sur le changement d'état et le traiter avant que votre application ne renvoie le tableau à Game Chat 2 en appelant [chat\_manager::finish\_processing\_state\_changes](/fr/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_finish_processing_state_changes).

Pour plus d'informations sur le traitement des changements d'état, consultez [Utilisation de l'API C++ de Game Chat 2](/fr/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2).

<a id="requirementsSection" />

## Configuration requise

**En-tête :** GameChat2.h

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

<a id="seealsoSection" />

## Documentation conceptuelle

* [Utilisation de l'API C++ de Game Chat 2](/fr/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2)

## Voir aussi

[Présentation de Game Chat 2](/fr/services/xbox-services/multiplayer/chat/game-chat2/game-chat-2-intro)\
[chat\_manager](/fr/reference/chat/gamechat2/classes/chat_manager/chat_manager)\
[Membres de GameChat2](/fr/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)