chat_manager::start_processing_state_changes
前回の呼び出し以降に処理すべき Game Chat の状態変化のすべての配列を取得します。構文
パラメーター
stateChangeCount _Out_Type: uint32_t* アプリが処理する game_chat_state_change エントリの数を stateChanges 配列に書き込む場所。 stateChanges _Outptr_result_buffer_(*stateChangeCount)
Type: game_chat_state_change_array* アプリが処理し、その後 chat_manager::finish_processing_state_changes() に渡すすべての game_chat_state_change エントリの配列へのポインターを格納する場所。
戻り値
Type: void解説
このメソッドは、前回の呼び出し以降にアプリで現在利用可能なすべての変化のリストを提供します。アプリは、提供された 0 個以上の変化の配列を使用して自身の状態や UI を更新し、その後速やかに chat_manager::finish_processing_state_changes() をそれらとともに呼び出す必要があります。 前回の呼び出しで返された状態変化オブジェクトのリストに対して chat_manager::finish_processing_state_changes() を呼び出さずに chat_manager::start_processing_state_changes() を再度呼び出すと、このメソッドは例外をスローします。状態変化エントリが 0 個返された場合でも、chat_manager::start_processing_state_changes() で返された値を使用して、常に chat_manager::finish_processing_state_changes() を呼び出す必要があります。 chat_manager::start_processing_state_changes() を呼び出した後は、対応する chat_manager::finish_processing_state_changes() の呼び出しが行われるまで、chat_manager::remove_user() を呼び出してはなりません。状態変化の処理中に chat_manager::remove_user() を呼び出すと、そのユーザーに関連付けられているメモリへのポインターが状態変化で返された場合でも、削除されたユーザーに関連付けられているメモリが無効化されます。要件
ヘッダー: GameChat2.h サポートされているプラットフォーム: Windows、XBOX One ファミリ本体および XBOX Series 本体関連項目
chat_managergame_chat_state_change
game_chat_state_change_array
chat_manager::finish_processing_state_changes
chat_manager::remove_user