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.0.0 for Windows">
7<META http-equiv="Content-Style-Type" content="text/css">
8<title>WM_EndMP</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">WM_EndMP&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
19<A href="WMErrCode.html">WMErrCode</A> WM_EndMP( <A href="WMCallbackFunc.html">WMCallbackFunc</A> callback );
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">callback</FONT></STRONG></EM></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  </tbody>
31</table>
32
33<h2>Return Values</h2>
34<p>Returns the results of the <CODE><A href="WMErrCode.html">WMErrCode</A></CODE> enumerated type process.</p>
35
36<H2>Description</H2>
37<P>Ends the MP mode This function is executable only when the WM state is in either the <a href="wm_state_diagram.html"><code>MP_PARENT</code></a> or <a href="wm_state_diagram.html"><code>MP_CHILD</code></a> state. If the return value for the API is <CODE>WM_ERRCODE_OPERATING</CODE>, a callback is generated after the MP mode termination process is complete. The WM state goes back to its original <a href="wm_state_diagram.html"><code>PARENT</code></a> or <a href="wm_state_diagram.html"><code>CHILD</code></a> state.</P>
38
39<P>
40When a child that performs MP communication calls the <CODE>WM_EndMP</CODE> function, the parent returns NULL for the communication from then on. When this status exceeds the MP communication lifetime set with the <a href="WM_SetLifeTime.html"><code>WM_SetLifeTime</code></a> function, the child is disconnected from the parent. Note that when data is sent from a parent to the child in this condition by MP communication, the parent receives the send successful notice, but the child discards all the received data.
41</P>
42
43<h2>See Also</h2>
44<p><a href="WM_StartMP.html"><code>WM_StartMP</code></a>, <a href="WM_StartMPEx.html"><code>WM_StartMPEx</code></a>, <a href="WM_SetMPDataToPort.html"><code>WM_SetMPDataToPort</code></a>, <a href="WM_SetPortCallback.html"><code>WM_SetPortCallback</code></a></p>
45
46<H2>Revision History</H2>
47<P>
482005/06/08 Added statement about callback being called from the interrupt handler.<br>2004/11/09 Added description about NULL reply.<br>2004/10/22 Changed type of return value.<br>2004/09/25 Added to and revised description.<br>2004/07/29 Added to Description<br>2004/07/23 Initial version
49</P>
50<hr><p>CONFIDENTIAL</p></body>
51</html>
52