> ## 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 멤버](/reference/chat/gamechat2/gamechat2_members)


## Related topics

- [chat_manager::finish_processing_data_frames](/ko/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_finish_processing_data_frames.md)
- [chat_manager::process_incoming_data](/ko/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_process_incoming_data.md)
- [chat_manager::start_processing_data_frames](/ko/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_start_processing_data_frames.md)
- [chat_manager::add_remote_user](/ko/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_add_remote_user.md)
- [game_chat_data_transport_requirement](/ko/reference/chat/gamechat2/enums/game_chat_data_transport_requirement.md)