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>WVR_TerminateAsync</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">WVR_TerminateAsync <img src="../../image/NTR.gif"></h1>
15<h2>Syntax</h2>
16<dl>
17  <dd><PRE><CODE>#include &lt;nitro/wvr.h&gt;
18
19<A href="WVRResult.html">WVRResult</A> WVR_TerminateAsync(
20    <A href="WVRCallbackFunc.html">WVRCallbackFunc</A> callback ,
21    void*           arg
22);
23</CODE></PRE></dd>
24</dl>
25
26<h2>Arguments</h2>
27<table border="1" width="100%">
28  <tbody>
29    <TR>
30<TD width="200"><SPAN class="argument">callback</SPAN></TD>
31<TD width="800">Callback function to call when the asynchronous process completes. This callback is called from inside the interrupt handler.</TD>
32    </TR>
33    <TR>
34<TD width="200"><SPAN class="argument">arg</SPAN></TD>
35<TD width="800">Optional arguments to be passed to the callback function called when the asynchronous process is complete.</TD>
36    </TR>
37  </tbody>
38</table>
39
40<h2>Return Values</h2>
41<p>Returns the results of the <A href="WVRResult.html"><CODE>WVRResult</CODE></A> enumerated type process.</p>
42
43<H2>Description</H2>
44<P>
45Forcibly stops the wireless driver that is operating on the ARM7 side and deallocates the VRAM bank it was using. If the return value was <code>WVR_RESULT_OPERATING</code>, the callback function is called from inside the PXI receive interrupt handler when the asynchronous process is complete.<BR>This function is relevant only when the ichneumon or ichneumon.TWL components, which contains features for operating the wireless driver in VRAM, are being used. For all other components, <CODE>WVR_RESULT_DISABLE</CODE> is returned, and this function fails. If the ichneumon/ichneumon.TWL component is being used, stops the driver only if the wireless driver has been started by the <code><A href="WVR_StartUpAsync.html">WVR_StartUpAsync</A></code> function.<BR><BR>If the asynchronous process for this component completes as expected, the wireless communication features become unusable. If the communications process was running using the WM library after the driver was started up via the <A href="WVR_StartUpAsync.html"><CODE>WVR_StartUpAsync</CODE></A> function, the internal state of the WM library will forcibly be put into a <A href="../../wm/wm/wm_state_diagram.html">READY state</A>. Until the wireless driver is restarted via the <A href="WVR_StartUpAsync.html"><CODE>WVR_StartUpAsync</CODE></A> function again, subsequent WM asynchronous operation functions will return <code>WM_ERRCODE_DISABLE</code> to the callbacks. <font color="red">This does not mean that the WM library will be reset to a &quot;pre-initialization state.&quot;</font>Call the <A href="../../wm/wm/WM_Finish.html"><CODE>WM_Finish</CODE></A> function inside the callback of this function when you need to completely shut down the WM library.
46</P>
47
48<h2>See Also</h2>
49<p><A href="WVR_StartUpAsync.html"><CODE>WVR_StartUpAsync</CODE></A><BR> <A href="../../wm/wm/WM_Finish.html"><CODE>WM_Finish</CODE></A></p>
50
51<H2>Revision History</H2>
52<P>
532009/06/15 Added description related to the ichneumon.TWL component.</BR> 2005/06/27 Added statement about callback being called from the interrupt handler.</BR> 2005/03/14 Corrected mistake with link destination.<br> 2005/03/08 Standardized the use of the term &quot;interrupt&quot; in Japanese.</BR> 2005/03/01 Added to <B>Description</B>.<BR> 2005/02/16 Initial version.
54</P>
55<hr><p>CONFIDENTIAL</p></body>
56</html>
57