1<html>
2
3<head>
4<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<LINK rel="stylesheet" type="text/css" href="../CSS/revolution.css">
6
7<title>MPUpdateBeaconAsync</title>
8</head>
9
10<body>
11<h1>MPUpdateBeaconAsync</h1>
12
13<h2>C Specification</h2>
14<p>
15<dl>
16  <dd><pre><code>#include &lt;revolution/mp.h&gt;</code></pre>
17  </dd>
18  <dd><pre><code>s32 MPUpdateBeaconAsync ( <a href="MPCallback.html">MPCallback</a> <i><b>cb</b></i>, void* <i><b>userData</b></i> );</code></pre>
19  </dd>
20</dl>
21</p>
22
23<h2>Arguments</h2>
24<p>
25<table border="1">
26  <tr>
27<td valign="top" width="120" bgcolor="#ffffe8"><code><strong><em>cb</em></strong></code></td>
28<td width="520">Callback function to be called when an asynchronous function completes</td>
29  </tr>
30  <tr>
31<td valign="top" width="120" bgcolor="#ffffe8"><code><strong><em>userData</em></strong></code></td>
32<td width="520">Pointer value that is passed to the callback function and can be used at will in the application</td>
33  </tr>
34</table>
35</p>
36
37<h2>Return Values</h2>
38
39<P>Returns the processing results or a negative number if processing fails.</P>
40
41<h2>Description</h2>
42
43<p>The current settings are referenced and the game information is asynchronously updated and sent. After a beacon is sent once after updating, <code>cb</code> is called.</p>
44<p>In the previous implementation, the work region for the asynchronous function was passed as an argument, but this is no longer necessary. Instead, there is now a limit on the number of asynchronous functions that can be called at the same time. If this limit is exceeded, <code>MP_RESULT_BUSY</code> is given as the return value. In the present implementation, a total of 32 functions can be called at the same time, including both synchronous and asynchronous functions, from different MP libraries.</p>
45<p>The pointer to the user data passed to the callback function is passed to the <CODE>userData</CODE> argument. The pointer value specified here is passed to the callback function without being evaluated inside the library, so it is all right to specify an illegal value.</p>
46
47<h2>See Also</h2>
48<p>
49<code><a href="./MPSetUserGameInfo.html">MPSetUserGameInfo()</a></code>, <code><a href="./MPSetEntryFlag.html">MPSetEntryFlag()</a></code>, <code><a href="./MPUpdateBeacon.html">MPUpdateBeacon()</a></code>, <code><a href="./MPError.html">MPError</a></code>, <code><a href="./MPCallback.html">MPCallback</a></code>, <code><a href="./MPCallbackInfo.html">MPCallbackInfo</a></code>
50</p>
51
52<h2>Revision History</h2>
53
54<p>
552007/11/28 Corrected errors.<br>2007/10/03 Made revisions in line with change to final argument.<br>2006/08/22 Added a description of block. <br>2006/06/29 Initial version.
56</p>
57
58<hr><p>CONFIDENTIAL</p></body>
59</html>