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

表示有关必须传送到远程 Game Chat 2 终结点的传出 Game Chat 2 数据的信息。

<a id="syntaxSection" />

## 语法

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

### 成员

*target\_endpoint\_identifier\_count*\
类型:uint32\_t

在 *target\_endpoint\_identifiers* 中指定的远程终结点标识符的数量。

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

必须向其传输此数据的一个或多个远程终结点标识符的数组。该数组具有 *target\_endpoint\_identifier\_count* 中指定的成员数。

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

数据的传输要求。

*packet\_byte\_count*\
类型:uint32\_t

必须传输给 *target\_endpoint\_identifiers* 指定的远程终结点的数据缓冲区的大小。

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

指向必须传输给 *target\_endpoint\_identifiers* 指定的远程终结点的数据缓冲区的指针。

<a id="remarksSection" />

## 备注

此结构表示有关必须传送到远程 Game Chat 2 终结点的传出 Game Chat 2 数据(例如音频数据)的信息。`game_chat_data_frame` 结构由 [chat\_manager::start\_processing\_data\_frames](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_start_processing_data_frames) 方法报告。应用处理数据帧后,应立即通过调用 [chat\_manager::finish\_processing\_data\_frames](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_finish_processing_data_frames) 方法将其归还。

`target_endpoint_identifiers` 数组的内存在通过调用 `chat_manager::finish_processing_data_frames` 归还此对象之前保持有效。该数组中可能的终结点标识符值是之前通过调用 [chat\_manager::add\_remote\_user](/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_add_remote_user) 方法指定的值。

<a id="array" />

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

`game_chat_data_frame_array` 类型是 `game_chat_data_frame` 指针的常量数组。此类型为方便使用而提供,并与 `chat_manager::start_processing_data_frames` 和 `chat_manager::finish_processing_data_frames` 方法一起使用。

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

<a id="requirementsSection" />

## 需求

**头文件:** GameChat2.h

**支持的平台:** Windows、XBOX One 家族主机以及 XBOX Series 主机

<a id="seealsoSection" />

## 概念性文档

* [Game Chat 2 简介](/services/xbox-services/multiplayer/chat/game-chat2/game-chat-2-intro)
* [使用 Game Chat 2 C++ API](/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2)

## 另请参阅

[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](/zh-CN/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_finish_processing_data_frames.md)
- [chat_manager::process_incoming_data](/zh-CN/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_process_incoming_data.md)
- [chat_manager::start_processing_data_frames](/zh-CN/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_start_processing_data_frames.md)
- [chat_manager::add_remote_user](/zh-CN/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_add_remote_user.md)
- [game_chat_data_transport_requirement](/zh-CN/reference/chat/gamechat2/enums/game_chat_data_transport_requirement.md)