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_StartDCF</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">WM_StartDCF <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_StartDCF(
20        <A href="WMCallbackFunc.html">WMCallbackFunc</A>  callback ,
21        WMDcfRecvBuf*   recvBuf ,
22        u16             recvBufSize
23);
24</CODE></PRE></dd>
25</dl>
26
27<h2>Arguments</h2>
28<TABLE width="100%">
29  <tbody>
30    <TR>
31<TD width="200"><CODE>callback</CODE></TD>
32<TD width="800">Specifies the callback function to be called when the notification of the status for the asynchronous process is sent or when the asynchronous process completes. This callback is called from within the interrupt handler.</TD>
33    </TR>
34    <TR>
35<TD width="200"><CODE>recvBuf</CODE></TD>
36<TD width="800">Pointer to the data receive buffer. Because the ARM7 processor writes directly to the buffer, be careful of coherency with the cache.</TD>
37    </TR>
38    <TR>
39<TD width="200"><CODE>recvBufSize</CODE></TD>
40<TD width="800">Size of the data receive buffer.</TD>
41    </TR>
42  </tbody>
43</table>
44
45<h2>Return Values</h2>
46<p>Returns the results of the <CODE><A href="WMErrCode.html">WMErrCode</A></CODE> enumerated type process.</p>
47
48<H2>Description</H2>
49<P>Starts infrastructure mode communications. This function is only executable when the WM is in the <code>CHILD</code> state. If the return value is <CODE>WM_ERRCODE_OPERATING</CODE>, a callback is generated after the communication mode change process is complete. The WM changes to the <code>DCF CHILD</code> state. A callback is also generated when the data is received in the infrastructure mode.</P>
50
51<H2>Notes</H2>
52<P>The <CODE>recvBuf</CODE> 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>
53
54<h2>See Also</h2>
55<p><CODE><A href="WM_SetDCFData.html">WM_SetDCFData, </A><A href="WM_EndDCF.html">WM_EndDCF</A></CODE></p>
56
57<H2>Revision History</H2>
58<P>
592008/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>
60</P>
61<hr><p>CONFIDENTIAL</p></body>
62</html>
63