Skip to main content

XblMultiplayerManagerDoWork

维护游戏与多人游戏管理器 (MPM) 之间的游戏状态更新。

语法

参数

multiplayerEvents   
类型:Deref_out_opt
游戏要处理的多人游戏事件的数组。如果在此次更新期间没有发生多人游戏事件,则此项设置为 null。 multiplayerEventsCount   _Out_
类型:size_t*
multiplayerEvents 数组的大小。

返回值

类型:HRESULT 此 API 操作的 HRESULT 返回代码。

备注

此函数在游戏与多人游戏管理器 (MPM) 之间发送和接收游戏状态更新,返回一个 XblMultiplayerEvent 结构数组,这些结构表示重要的多人游戏事件,例如远程玩家的加入或离开。你必须定期且频繁地调用此函数,例如每帧调用一次,以便 MPM 可以正确地维护游戏状态。有关详细信息,请参阅多人游戏管理器概述
此函数返回的多人游戏事件归 MPM 所有,仅在再次调用 XblMultiplayerManagerDoWork 之前保持有效。此外,在调用 XblMultiplayerManagerDoWork 时,游戏必须是线程安全的,因为在调用此函数时游戏状态会发生变化。例如,如果你在与调用此函数的线程不同的另一个线程上遍历成员列表,则在调用此函数时,该列表可能会发生变化。

要求

头文件: multiplayer_manager_c.h 库: Microsoft.Xbox.Services.14x.GDK.C.lib

另请参阅

multiplayer_manager_c
最后修改于 2026年8月13日