> ## 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.

# XblMultiplayerManagerDoWork

> XblMultiplayerManagerDoWork

# XblMultiplayerManagerDoWork

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

## 语法

```cpp theme={null}
HRESULT XblMultiplayerManagerDoWork(  
         const _Deref_out_opt_ multiplayerEvents,  
         size_t* multiplayerEventsCount  
)  
```

### 参数

*multiplayerEvents*   \
类型：*Deref\_out\_opt*

游戏要处理的多人游戏事件的数组。如果在此次更新期间没有发生多人游戏事件，则此项设置为 null。

*multiplayerEventsCount*   \_Out\_\
类型：size\_t\*

`multiplayerEvents` 数组的大小。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

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

## 要求

**头文件：** multiplayer\_manager\_c.h

**库：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另请参阅

[multiplayer\_manager\_c](/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members)


## Related topics

- [Multiplayer Manager 概述](/zh-CN/services/xbox-services/multiplayer/mpm/live-multiplayer-manager-overview.md)
- [XblMultiplayerManagerSetJoinability](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagersetjoinability.md)
- [XblMultiplayerManagerInitialize](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerinitialize.md)
- [Multiplayer Manager API 概述](/zh-CN/services/xbox-services/multiplayer/mpm/concepts/live-multiplayer-manager-api-overview.md)
- [XblMultiplayerEvent](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerevent.md)