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

> game_chat_data_frame

# game\_chat\_data\_frame

Represents information about outgoing Game Chat 2 data that must be delivered to remote Game Chat 2 endpoints.

<a id="syntaxSection" />

## Syntax

```cpp theme={null}
typedef struct game_chat_data_frame {  
    uint32_t target_endpoint_identifier_count;  
    uint64_t* target_endpoint_identifiers;  
    game_chat_data_transport_requirement transport_requirement;  
    uint32_t packet_byte_count;  
    uint8_t* packet_buffer;  
} game_chat_data_frame  
```

<a id="membersSection" />

### Members

*target\_endpoint\_identifier\_count*\
Type: uint32\_t

The number of remote endpoint identifiers specified in *target\_endpoint\_identifiers*.

*target\_endpoint\_identifiers*  \_Field\_size\_(target\_endpoint\_identifier\_count)\
Type: uint64\_t\*

An array of one or more remote endpoint identifiers to which this data must be transmitted. The array has the number of members specified in *target\_endpoint\_identifier\_count*.

*transport\_requirement*\
Type: [game\_chat\_data\_transport\_requirement](/reference/chat/gamechat2/enums/game_chat_data_transport_requirement)

The transport requirements for the data.

*packet\_byte\_count*\
Type: uint32\_t

The size of the data buffer that must be transmitted to the remote endpoints specified by *target\_endpoint\_identifiers*.

*packet\_buffer*  \_Field\_size\_(packet\_byte\_count)\
Type: uint8\_t\*

A pointer to the data buffer that must be transmitted to the remote endpoints specified by *target\_endpoint\_identifiers*.

<a id="remarksSection" />

## Remarks

This structure represents information about outgoing Game Chat 2 data, such as audio data, that must be delivered to remote Game Chat 2 endpoints. `game_chat_data_frame` structures are reported by the [chat\_manager::start\_processing\_data\_frames](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_start_processing_data_frames) method. The app processes the data frames, and then promptly passes them back by calling the [chat\_manager::finish\_processing\_data\_frames](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_finish_processing_data_frames) method.

The memory for the `target_endpoint_identifiers` array remains valid until this object has been returned by calling `chat_manager::finish_processing_data_frames`. The possible endpoint identifier values in that array are those that have been previously specified by calls to the [chat\_manager::add\_remote\_user](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_add_remote_user) method.

<a id="array" />

### game\_chat\_data\_frame\_array

The `game_chat_data_frame_array` type is a constant array of `game_chat_data_frame` pointers. This type is provided for convenience, and is used with the `chat_manager::start_processing_data_frames` and `chat_manager::finish_processing_data_frames` methods.

```cpp theme={null}
typedef class game_chat_data_frame * const * game_chat_data_frame_array;
```

<a id="requirementsSection" />

## Requirements

**Header:** GameChat2.h

**Supported platforms:** Windows, XBOX One family consoles and XBOX Series consoles

<a id="seealsoSection" />

## Conceptual documentation

* [Intro to Game Chat 2](/services/xbox-services/multiplayer/chat/game-chat2/game-chat-2-intro)
* [Using the Game Chat 2 C++ API](/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2)

## See also

[Intro to Game Chat 2](/services/xbox-services/multiplayer/chat/game-chat2/game-chat-2-intro)\
[chat\_manager](/reference/chat/gamechat2/classes/chat_manager/chat_manager)\
[GameChat2 members](/reference/chat/gamechat2/gamechat2_members)


## Related topics

- [chat_manager::finish_processing_data_frames](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_finish_processing_data_frames.md)
- [chat_manager::start_processing_data_frames](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_start_processing_data_frames.md)
- [game_chat_data_transport_requirement](/reference/chat/gamechat2/enums/game_chat_data_transport_requirement.md)
- [Using the Game Chat 2 C++ API](/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2.md)
- [chat_manager::process_incoming_data](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_process_incoming_data.md)