XblMultiplayerManagerDoWork
타이틀과 Multiplayer Manager(MPM) 간의 게임 상태 업데이트를 유지 관리합니다.Syntax
Parameters
multiplayerEventsType: Deref_out_opt 게임이 처리할 멀티플레이어 이벤트 배열입니다. 이 업데이트 중에 멀티플레이어 이벤트가 발생하지 않으면 null로 설정됩니다. multiplayerEventsCount _Out_
Type: size_t*
multiplayerEvents 배열의 크기입니다.
Return value
Type: HRESULT 이 API 작업에 대한 HRESULT 반환 코드입니다.Remarks
이 함수는 타이틀과 Multiplayer Manager(MPM) 간에 게임 상태 업데이트를 보내고 받으며, 원격 플레이어 참여 또는 이탈과 같은 중요한 멀티플레이어 이벤트를 나타내는 XblMultiplayerEvent 구조체의 배열을 반환합니다. MPM이 게임 상태를 올바르게 유지 관리할 수 있도록 프레임당 한 번 등 이 함수를 정기적이고 빈번하게 호출해야 합니다. 자세한 내용은 Multiplayer Manager 개요를 참조하세요.이 함수에서 반환된 멀티플레이어 이벤트는 MPM이 소유하며
XblMultiplayerManagerDoWork가 다시 호출될 때까지만 유효합니다. 또한 이 함수 호출 시 게임 상태가 변경되므로 XblMultiplayerManagerDoWork를 호출할 때 타이틀은 스레드로부터 안전해야 합니다. 예를 들어 이 함수를 호출하는 스레드가 아닌 다른 스레드에서 멤버 목록을 반복하는 경우 이 함수가 호출될 때 목록이 변경될 수 있습니다.