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_ReadMPData</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">WM_ReadMPData&nbsp;<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
19WMMpRecvData* WM_ReadMPData( const WMMpRecvHeader* header , u16 aid );
20</CODE></PRE></dd>
21</dl>
22
23<h2>Arguments</h2>
24<table border="1" width="100%">
25  <tbody>
26    <TR>
27      <TD width="200"><EM><STRONG><FONT face="Courier New">header</FONT></STRONG></EM></TD>
28      <TD width="800">Pointer to the header structure of all received data.</TD>
29    </TR>
30    <TR>
31      <TD width="200"><EM><STRONG><FONT face="Courier New">aid</FONT></STRONG></EM></TD>
32      <TD width="800">Specifies the AID of the child whose data you want to extract. Use a value from 1-15.</TD>
33    </TR>
34  </tbody>
35</table>
36
37<h2>Return Values</h2>
38<p>Returns a pointer to the data structure received from the child specified in the <code>aid</code> argument. Returns a value of NULL if the operation fails.</p>
39
40<H2>Description</H2>
41<p>The method that uses this API to get the receive data from the notification of <code>WM_STATECODE_MPEND_IND</code> is obsolete. For the normal process to receive data, use the callback set with <A href="WM_SetPortCallback.html"><code>WM_SetPortCallback</code></A>.</p>
42<p>When notification of <CODE>WM_STATECODE_MPEND_IND</CODE> comes to the callback for <A href="WM_StartMP.html"><CODE>WM_StartMP</CODE></A>, it returns a pointer to the receive data structure from a child specified by the argument <code>aid</code> from the structure of the entire receive data assigned to <code>WMStartMPCallback.recvBuf</code>. Returns a value of NULL if the operation fails. <code>WMStartMPCallback.recvBuf</code> is defined as the <code>WMMpRecvBuf*</code> type, and it needs to be cast as type <code>WMMpRecvHeader*</code>.</p>
43
44<h2>See Also</h2>
45<p><CODE><A href="WM_StartMP.html">WM_StartMP</A>, <A href="WM_EndMP.html">WM_EndMP</A>, <A href="WM_SetMPData.html">WM_SetMPData</A>, <A href="WM_SetPortCallback.html">WM_SetPortCallback</A></CODE></p>
46
47<H2>Revision History</H2>
48<P>
492005/03/02 Added description of allowable range for aid argument.<br /> 2004/11/04 Revised text about obsolete method to the top.<br> 2004/09/25 Added and revised descriptions.<br> 2004/07/29 Added descriptions.<br> 2004/07/23 Initial version.
50</P>
51<hr><p>CONFIDENTIAL</p></body>
52</html>
53