Syntax
Parameters
multiplayerEvents   _Deref_out_opt_Type: const XblMultiplayerEvent** An array of multiplayer events for the game to handle. This is set to null if no multiplayer events occur during this update. multiplayerEventsCount   _Out_
Type: size_t* The size of the
multiplayerEvents array.
Return value
Type: HRESULT ReturnsS_OK on success, including when no events occurred. When there are no events, multiplayerEvents is set to null and multiplayerEventsCount is set to 0. Possible error codes include the following. This list isn’t exhaustive.
If either of these errors occurs, a non-null
multiplayerEvents is set to null and multiplayerEventsCount isn’t written.
Remarks
Call XblMultiplayerManagerInitialize before you call this function. This function sends and receives game state updates between the title and Multiplayer Manager (MPM), returning an array of XblMultiplayerEvent structures that represent significant multiplayer events, such as remote players joining or leaving. You must call this function on a regular and frequent basis, such as once per frame, so that MPM can properly maintain game state. For more information, see Multiplayer Manager overview.The multiplayer events returned by this function are owned by MPM, and remain valid only until
XblMultiplayerManagerDoWork is called again. In addition, the title must be thread-safe when calling XblMultiplayerManagerDoWork, because game state changes at the time this function is called. For example, if you’re iterating through the list of members on a thread other than the one from which you’re calling this function, the list may change when this function is called.