Skip to main content

chat_manager::start_processing_state_changes

检索自上次调用以来所有要处理的 Game Chat 状态更改的数组。

语法

参数

stateChangeCount _Out_
类型:uint32_t*
用于写入应用要在 stateChanges 数组中处理的 game_chat_state_change 条目数量的位置。 stateChanges _Outptr_result_buffer_(*stateChangeCount)
类型:game_chat_state_change_array*
用于存储指向所有 game_chat_state_change 条目数组的指针的位置,应用需要处理这些条目并将它们传递给 chat_manager::finish_processing_state_changes()。

返回值

类型: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_manager
game_chat_state_change
game_chat_state_change_array
chat_manager::finish_processing_state_changes
chat_manager::remove_user
最后修改于 2026年8月24日