> ## 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-CA/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-CA/reference/chat/gamechat2/classes/chat_user/chat_user)\*

Un 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 ait été retiré de l'instance locale de [chat\_manager](/fr-CA/reference/chat/gamechat2/classes/chat_manager/chat_manager) au moyen de la méthode [chat\_manager::remove\_user](/fr-CA/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_remove_user).

*receiver\_count*  \
Type : uint32\_t

Le nombre d'éléments du tableau *receivers*.

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

Un tableau de pointeurs `chat_user` vers un ou plusieurs joueurs locaux destinataires auxquels le message texte est adressé.

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

*message*  \
Type : PCWSTR

Un pointeur vers la chaîne de texte envoyée en appelant [chat\_user\_local::send\_chat\_text](/fr-CA/reference/chat/gamechat2/classes/chat_user/chat_user_local/methods/chat_user_local_send_chat_text). La chaîne peut compter 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é retourné 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 la politique 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-CA/reference/chat/gamechat2/enums/game_chat_state_change_type) dans Game Chat 2. Ce changement d'état se produit lorsqu'une communication textuelle d'un joueur à un autre est arrivée.

Si ce changement d'état se produit, cette structure est retournée en tant qu'élément [game\_chat\_state\_change](/fr-CA/reference/chat/gamechat2/structs/game_chat_state_change) dans le tableau [game\_chat\_state\_change\_array](/fr-CA/reference/chat/gamechat2/structs/game_chat_state_change#array) récupéré lorsque votre application appelle [chat\_manager::start\_processing\_state\_changes](/fr-CA/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'information sur le changement d'état et le traiter avant que votre application renvoie le tableau à Game Chat 2 en appelant [chat\_manager::finish\_processing\_state\_changes](/fr-CA/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_finish_processing_state_changes).

Pour plus d'information sur le traitement des changements d'état, consultez [Utilisation de l'API C++ de Game Chat 2](/fr-CA/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-CA/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2)

## Voir aussi

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