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 時必須是安全執行緒,因為遊戲狀態會在呼叫此函式時變更。例如,如果您在呼叫此函式的執行緒以外的執行緒上逐一查看成員清單,則清單可能會在呼叫此函式時變更。
