Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Represents information about outgoing Game Chat 2 data that must be delivered to remote Game Chat 2 endpoints.
Syntax
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
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
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.
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 method. The app processes the data frames, and then promptly passes them back by calling the 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 method.
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.
typedef class game_chat_data_frame * const * game_chat_data_frame_array;
Requirements
Header: GameChat2.h
Supported platforms: Windows, Xbox One family consoles and Xbox Series consoles