nn::nex::MatchmakeRefereeClient::EndRound Member Function

Syntax

qBool EndRound(
     ProtocolCallContext * pCC,
     const MatchmakeRefereeEndRoundParam & endRoundParam
);

Parameters

Name Description
in pCC Call information.
in endRoundParam Report to send to the server. Sets the results for all round participants in endRoundParam.personalRoundResults.

Return Values

Returns the result of the operation.

Description

Ends a round and sends a report.

Reports the results of the round to the server.
Called when the round has completed.
Stop collecting statistics and summarize statistics when the reports of all participants have been gathered, all participants have disconnected, or one minute has passed after the first report was sent. If this API is called for the first time after the StartRound function is called, round participants are notified with NotificationEvents::FirstRoundReportReceived.
When summarizing statistics has completed, a NotificationEvents::RoundSummarized notification is sent to the round participants.

For more information about the statistics in the report that is sent, see the Programming Manual.

Returns QERROR(MatchmakeReferee, InvalidArgument) if the personalRoundResults set in endRoundParam has the size of buffer that exceeds MatchmakeRefereeConstants::STATS_BUFFER_MAX_SIZE. Returns QERROR(MatchmakeReferee, InvalidArgument) if the size of PersonalRoundResults set in endRoundParam is not equal to the number of participants.
Returns QERROR(MatchmakeReferee, RoundNotFound) if there is no target round to report.
Returns QERROR(MatchmakeReferee, AlreadyExists) if the round to report has been reported.
Returns QERROR(MatchmakeReferee, RoundArbitrated) if the summarizing statistics for the round to report have already completed.
Returns QERROR(MatchmakeReferee, RoundNotFound) if a user is not participating in the round to report.

Revision History

2014/09/16
The function now returns QERROR(MatchmakeReferee, AlreadyExists) instead of QERROR(PythonCore, Exception) if a round has already been reported.
2014/01/29
Added a note referring developers to the programming manual for more information about the statistics in the report that is sent, and added a description of the endRoundParam parameter.
2013/12/06
Initial version.

CONFIDENTIAL