Skip to main content

XblMultiplayerManagerDoWork

維護遊戲與 Multiplayer Manager (MPM) 之間的遊戲狀態更新。

語法

參數

multiplayerEvents   
類型:Deref_out_opt
供遊戲處理的多人遊戲事件陣列。如果此更新期間沒有發生多人遊戲事件,則會設為 null。 multiplayerEventsCount   _Out_
類型:size_t*
multiplayerEvents 陣列的大小。

傳回值

類型:HRESULT 此 API 作業的 HRESULT 傳回碼。

備註

此函式會在遊戲與 Multiplayer Manager (MPM) 之間傳送及接收遊戲狀態更新,並傳回 XblMultiplayerEvent 結構的陣列,代表重要的多人遊戲事件,例如遠端玩家加入或離開。您必須定期且頻繁地呼叫此函式 (例如每個畫面格一次),讓 MPM 能夠正確維護遊戲狀態。如需詳細資訊,請參閱 Multiplayer Manager 概觀。
此函式傳回的多人遊戲事件由 MPM 擁有,且只在再次呼叫 XblMultiplayerManagerDoWork 之前有效。此外,遊戲在呼叫 XblMultiplayerManagerDoWork 時必須是安全執行緒,因為遊戲狀態會在呼叫此函式時變更。例如,如果您在呼叫此函式的執行緒以外的執行緒上逐一查看成員清單,則清單可能會在呼叫此函式時變更。

需求

標頭: multiplayer_manager_c.h 程式庫: Microsoft.Xbox.Services.14x.GDK.C.lib

另請參閱

multiplayer_manager_c
Last modified on October 6, 2026