1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
6<META http-equiv="Content-Style-Type" content="text/css">
7<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows">
8<title>DWCEvalPlayerCallback</title>
9<LINK rel="stylesheet" href="../css/nitro.css" type="text/css">
10</head>
11
12<body>
13<a name="dwc__match_8h_1546369b77983a0a5e7b8609d236ba937"></a>
14<h1 align="left">DWCEvalPlayerCallback</h1>
15<h2>Syntax</h2>
16
17<dl>
18  <dd>
19<CODE>#include &lt;dwc.h&gt;</CODE><BR>
20  <BR>
21  <PRE><CODE>typedef int(*) <a href=DWCEvalPlayerCallback.html#dwc__match_8h_1546369b77983a0a5e7b8609d236ba937>DWCEvalPlayerCallback</a>(int index,
22            void *param);</CODE></PRE></dd>
23</dl>
24
25<h2>Arguments</h2>
26
27<TABLE border="1" width="100%">
28  <TBODY>
29
30    <TR>
31<TD width="13%"><EM><STRONG><parametername>index</parametername></STRONG></EM></TD>
32<TD width="87%">Index of player to be evaluated. This index must be passed to the function that gets the matchmaking key value.</TD>
33    </TR>
34
35    <TR>
36<TD width="13%"><EM><STRONG><parametername>param</parametername></STRONG></EM></TD>
37<TD width="87%">Callback parameter.</TD>
38    </TR>
39
40  </TBODY>
41</TABLE>
42
43<h2>Return Values</h2>
44
45<p>Returns the player's evaluation value. The player falls outside the scope of matchmaking if a value less than or equal to zero is returned.</p>
46
47<H2>Description</H2>
48<p>This function is called every time a player targeted for matchmaking is found when performing peer matchmaking with friend specified/unspecified. The larger a player's return value, the more likely that player will be selected as a connection target.</p><p>Values specified using the <a href=DWC_AddMatchKeyString.html#dwc__match_8h_1a6dc592558f9f69faff4f1911782f3a8><CODE>DWC_AddMatchKeyString</CODE></a> and <a href=DWC_AddMatchKeyInt.html#dwc__match_8h_1c6b58c2fcd1265657a5689de46e8ea7e><CODE>DWC_AddMatchKeyInt</CODE></a> functions can be obtained and used as a basis for rating.</p><p>It takes some time for the addition of a condition key to be propagated to the server. Thus, even if the application sets the condition key, it will sometimes be determined to not exist, and the default value will be returned.</p>
49
50<h2>See Also</h2>
51<p>
52
53<CODE><A href="DWC_ConnectToFriendsAsync.html">DWC_ConnectToFriendsAsync<BR></A></CODE>
54
55<CODE><A href="DWC_ConnectToAnybodyAsync.html">DWC_ConnectToAnybodyAsync</A></CODE>
56
57<CODE><A href="DWC_AddMatchKeyString.html">DWC_AddMatchKeyString</A></CODE>
58
59<CODE><A href="DWC_AddMatchKeyInt.html">DWC_AddMatchKeyInt</A></CODE>
60
61<CODE><A href="DWC_GetMatchStringValue.html">DWC_GetMatchStringValue</A></CODE>
62
63<CODE><A href="DWC_GetMatchIntValue.html">DWC_GetMatchIntValue</A></CODE>
64
65</p>
66
67<H2>Revision History</H2>
68<DL>
69
70<DT><para>1.4.20</DT>
71<DD>Noted that it takes some time for the addition of a condition key to be propagated to the server.</DD>
72
73</DL>
74<hr><p>CONFIDENTIAL</p></body>
75</html>
76