1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<HTML>
3<HEAD>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<META http-equiv="Content-Style-Type" content="text/css">
6<TITLE>NWC24TrySuspendScheduler</TITLE>
7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
8</HEAD>
9<BODY>
10<H1>NWC24TrySuspendScheduler</H1>
11
12<H2>C Specification</H2>
13<DL>
14<DD><PRE><CODE>#include &lt;revolution/nwc24.h&gt;</CODE></PRE>
15<DD><PRE><CODE>s32 NWC24TrySuspendScheduler( void );</CODE></PRE>
16</DL>
17
18<H2>Description</H2>
19<P>
20Attempts to pause the auto-scheduler. Although there is no blocking until paused, this function will fail if a scheduler process is underway.<BR>
21</P>
22
23<H2>Arguments</H2>
24<P>
25None.
26</P>
27
28<h2>Return Values</h2>
29<P>
30Returns a suspend counter if the pause is successful.<BR><BR> When 0 is returned, it indicates that the auto-schedule was in an executable state before the process began.<BR> When a positive number is returned. it indicates it was paused before the process began. <BR>One of the following is returned when the process fails:</P>
31<P>
32<code>NWC24_ERR_FATAL</code>: Fatal error<BR> <code>NWC24_ERR_INTERNAL_IPC</code>: Problem with internal process.<BR> <code>NWC24_ERR_INPROGRESS</code>: Scheduler has not started.<BR> <code>NWC24_ERR_MUTEX</code>: There is another context calling a scheduler function.<BR> <code>NWC24_ERR_BUSY</code>: The scheduler is executing an automatic process.
33</P>
34
35<H2>See Also</H2>
36<P>
37<A href="NWC24SuspendScheduler.html"><CODE>NWC24SuspendScheduler</CODE></A>, <A href="NWC24ResumeScheduler.html"><CODE>NWC24ResumeScheduler</CODE></A>
38</P>
39
40<H2>Revision History</H2>
41<P>2006/09/01 Initial version.</P>
42
43<hr><p>CONFIDENTIAL</p></body>
44</HTML>