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

維護遊戲與 Multiplayer Manager (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 傳回碼。

## 備註

此函式會在遊戲與 Multiplayer Manager (MPM) 之間傳送及接收遊戲狀態更新，並傳回 [XblMultiplayerEvent](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerevent) 結構的陣列，代表重要的多人遊戲事件，例如遠端玩家加入或離開。您必須定期且頻繁地呼叫此函式 (例如每個畫面格一次)，讓 MPM 能夠正確維護遊戲狀態。如需詳細資訊，請參閱 [Multiplayer Manager 概觀](/zh-TW/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](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members)


## Related topics

- [XblMultiplayerManagerSetJoinability](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagersetjoinability.md)
- [XblMultiplayerManagerInitialize](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerinitialize.md)
- [XblMultiplayerEvent](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerevent.md)
- [XblMultiplayerManagerMember](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayermanagermember.md)
- [多人遊戲管理員概觀](/zh-TW/services/xbox-services/multiplayer/mpm/live-multiplayer-manager-overview.md)