> ## 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](/zh-TW/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](/zh-TW/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_start_processing_data_frames) 方法回報。應用程式會處理資料框架，然後藉由呼叫 [chat\_manager::finish\_processing\_data\_frames](/zh-TW/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_finish_processing_data_frames) 方法立即將其傳回。

在藉由呼叫 `chat_manager::finish_processing_data_frames` 傳回此物件之前，`target_endpoint_identifiers` 陣列的記憶體都會保持有效。該陣列中可能的端點識別碼值，是先前呼叫 [chat\_manager::add\_remote\_user](/zh-TW/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 簡介](/zh-TW/services/xbox-services/multiplayer/chat/game-chat2/game-chat-2-intro)
* [使用 Game Chat 2 C++ API](/zh-TW/services/xbox-services/multiplayer/chat/game-chat2/using-game-chat-2)

## 另請參閱

[Game Chat 2 簡介](/zh-TW/services/xbox-services/multiplayer/chat/game-chat2/game-chat-2-intro)\
[chat\_manager](/zh-TW/reference/chat/gamechat2/classes/chat_manager/chat_manager)\
[GameChat2 成員](/zh-TW/reference/chat/gamechat2/gamechat2_members)


## Related topics

- [chat_manager::finish_processing_data_frames](/zh-TW/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_finish_processing_data_frames.md)
- [chat_manager::process_incoming_data](/zh-TW/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_process_incoming_data.md)
- [chat_manager::start_processing_data_frames](/zh-TW/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_start_processing_data_frames.md)
- [Game Chat 2 簡介](/zh-TW/services/xbox-services/multiplayer/chat/game-chat2/game-chat-2-intro.md)
- [chat_manager::add_remote_user](/zh-TW/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_add_remote_user.md)