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 name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 8.0.2.0 for Windows">
7<META http-equiv="Content-Style-Type" content="text/css">
8<title>WM_SetParentParameter</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">WM_SetParentParameter <img src="../../image/NTR.gif"><img src="../../image/TWL.gif"></H1>
15<h2>Syntax</h2>
16<dl>
17  <dd><PRE><CODE>#include &lt;nitro/wm.h&gt;
18
19<A href="WMErrCode.html">WMErrCode</A> WM_SetParentParameter( <A href="WMCallbackFunc.html">WMCallbackFunc</A> callback , const <A href="WMParentParam.html">WMParentParam</A>* pparaBuf );
20</CODE></PRE></dd>
21</dl>
22
23<h2>Arguments</h2>
24<TABLE width="100%">
25  <tbody>
26    <TR>
27<TD width="200"><CODE>callback</CODE></TD>
28<TD width="800">Designates the callback function to call when the asynchronous process completes. This callback is called from within the interrupt handler.</TD>
29    </TR>
30    <TR>
31<TD width="200"><CODE>pparaBuf</CODE></TD>
32<TD width="800">Pointer to the structure that shows parent information. Note that the <CODE>pparaBuf</CODE> and <CODE>pparaBuf&rarr;userGameInfo</CODE> entities are forcibly cached.</TD>
33    </TR>
34  </tbody>
35</table>
36
37<h2>Return Values</h2>
38<p>Returns the results of the <CODE><A href="WMErrCode.html">WMErrCode</A></CODE> enumerated type process.</p>
39
40<H2>Description</H2>
41<P>Sets the parameters that are required for a parent This API must be executed once before the <A href="WM_StartParent.html"><CODE>WM_StartParent</CODE></A> is called. This function is only executable when the WM is in the <code>IDLE</code> state. If the return value is <CODE>WM_ERRCODE_OPERATING</CODE>, a callback is generated after the parameter setting process is complete.</P>
42
43<H2>Notes</H2>
44<P>The pparaBuf and pparaBuf&rarr;userGameInfo data is forcibly stored in the internal cache. To avoid overwriting surrounding memory regions, be sure to pass data that is 32-byte aligned.<BR>See the Wireless Communication Library Manual (AboutWirelessManager.pdf) for additional details.</P>
45
46<h2>See Also</h2>
47<p><A href="WM_StartParent.html"><code>WM_StartParent</code></A><BR> <A href="WM_EndParent.html"><code>WM_EndParent</code></A><BR> <A href="WM_SetGameInfo.html"><code>WM_SetGameInfo</code></A></p>
48
49<H2>Revision History</H2>
50<P>
512008/12/17 Added a note about how data passed in arguments is forcibly cached internally.<BR>2005/06/08 Added the fact that the callback is called from the interrupt handler.<BR>2004/10/22 Changed the type of return values.<BR>2004/08/02 Standardized structure names.<BR>2004/07/29 Added to Description.<BR>2004/07/23 Initial version.<BR>
52</P>
53<hr><p>CONFIDENTIAL</p></body>
54</html>
55