vxwtask.html

vxworks相关论文

<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWTask::activate</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWTask::activate</i>(&nbsp;)</strong> - activate a task</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>    STATUS activate ()</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine activates tasks created by the form of the constructor 
that does not automatically activate a task.  Without activation, a
task is ineligible for CPU allocation by the scheduler.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK, or ERROR if the task cannot be activated.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><i><a href="./VXWTask.html#VXWTask::VXWTask">VXWTask::VXWTask</a></i>(&nbsp;)</b>

<hr>
<a name="VXWTask::deleteForce"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWTask::deleteForce</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWTask::deleteForce</i>(&nbsp;)</strong> - delete a task without restriction</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>    STATUS deleteForce ()</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine deletes a task even if the task is protected from deletion.  
It is similar to <b><i><a href="./VXWTask.html#VXWTask::~VXWTask">VXWTask::~VXWTask</a></i>(&nbsp;)</b>.  Upon deletion, all routines
specified by <b><i><a href="./taskHookLib.html#taskDeleteHookAdd">taskDeleteHookAdd</a></i>(&nbsp;)</b> are called in the context of the
deleting task.
<p>
</blockquote><h4>CAVEATS</h4><blockquote><p>
This routine is intended as a debugging aid, and is generally inappropriate
for applications.  Disregarding a task's deletion protection could leave the
the system in an unstable state or lead to system deadlock.
<p>
The system does not protect against simultaneous <b><i>VXWTask:deleteForce</i>(&nbsp;)</b> calls.
Such a situation could leave the system in an unstable state.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK, or ERROR if the task cannot be deleted.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><i><a href="./taskHookLib.html#taskDeleteHookAdd">taskDeleteHookAdd</a></i>(&nbsp;)</b>, <b><i><a href="./VXWTask.html#VXWTask::~VXWTask">VXWTask::~VXWTask</a></i>(&nbsp;)</b>

<hr>
<a name="VXWTask::envCreate"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWTask::envCreate</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWTask::envCreate</i>(&nbsp;)</strong> - create a private environment</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS envCreate
    (
    int envSource
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine creates a private set of environment variables for a specified
task, if the environment variable task create hook is not installed.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK, or ERROR if memory is insufficient.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./VXWTask.html#top">VXWTask</a></b>, <b><a href="./envLib.html#top">envLib</a></b>

<hr>
<a name="VXWTask::errNo"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWTask::errNo</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWTask::errNo</i>(&nbsp;)</strong> - retrieve error status value</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>    int errNo ()</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine gets the error status for the task.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
<p>
The error status value contained in <b>errno</b>.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./VXWTask.html#top">VXWTask</a></b>

<hr>
<a name="VXWTask::errNo_1"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWTask::errNo</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWTask::errNo</i>(&nbsp;)</strong> - set error status value </p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS errNo
    (
    int errorValue
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine sets the error status value for its task.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./VXWTask.html#top">VXWTask</a></b>

<hr>
<a name="VXWTask::id"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWTask::id</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWTask::id</i>(&nbsp;)</strong> - reveal task ID </p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>    int id ()</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine reveals the task ID for its task. The task ID is necessary
to call C routines that affect or inquire on a task.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
task ID
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./VXWTask.html#top">VXWTask</a></b>, <b><a href="./taskLib.html#top">taskLib</a></b>

<hr>
<a name="VXWTask::info"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWTask::info</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWTask::info</i>(&nbsp;)</strong> - get information about a task</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS info
    (
    TASK_DESC * pTaskDesc
    ) const</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine fills in a specified task descriptor (<b>TASK_DESC</b>) for its
task.  The information in the task descriptor is, for the most
part, a copy of information kept in the task control block (<b>WIND_TCB</b>).
The <b>TASK_DESC</b> structure is useful for common information and avoids
dealing directly with the unwieldy <b>WIND_TCB</b>.
<p>
</blockquote><h4>NOTE</h4><blockquote><p>
Examination of WIND_TCBs should be restricted to debugging aids.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./VXWTask.html#top">VXWTask</a></b>

<hr>
<a name="VXWTask::isReady"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWTask::isReady</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWTask::isReady</i>(&nbsp;)</strong> - check if task is ready to run</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>    BOOL isReady ()</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine tests the status field of its task to determine
whether the task is ready to run.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
TRUE if the task is ready, otherwise FALSE.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./VXWTask.html#top">VXWTask</a></b>

<hr>
<a name="VXWTask::isSuspended"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWTask::isSuspended</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWTask::isSuspended</i>(&nbsp;)</strong> - check if task is suspended</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>    BOOL isSuspended ()</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine tests the status field of its task to determine
whether the task is suspended.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
TRUE if the task is suspended, otherwise FALSE.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./VXWTask.html#top">VXWTask</a></b>

<hr>
<a name="VXWTask::kill"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWTask::kill</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWTask::kill</i>(&nbsp;)</strong> - send a signal to task</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>int kill
    (
    int signo
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine sends a signal <i>signo</i> to its task.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK (0), or ERROR (-1) if the signal number is invalid.
<p>
</blockquote><h4>ERRNO</h4><blockquote><p>
EINVAL
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./VXWTask.html#top">VXWTask</a></b>

<hr>
<a name="VXWTask::name"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWTask::name</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWTask::name</i>(&nbsp;)</strong> - get the name associated with a task ID</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>    char * name ()</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine returns a pointer to the name of its task, if
it has a name; otherwise it returns NULL.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
A pointer to the task name, or NULL.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./VXWTask.html#top">VXWTask</a></b>

<hr>
<a name="VXWTask::options"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWTask::options</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWTask::options</i>(&nbsp;)</strong> - examine task options</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS options
    (
    int * pOptions
    ) const</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine gets the current execution options of its task.
The option bits returned indicate the following modes:
<dl>
<dt>
<b>VX_FP_TASK</b>
<dd>

execute with floating-point coprocessor support.
<p>
<dt>
<b>VX_PRIVATE_ENV</b>
<dd>

include private environment support (see <b><a href="./envLib.html#top">envLib</a></b>).
<p>
<dt>
<b>VX_NO_STACK_FILL</b>
<dd>

do not fill the stack for use by <b><i>checkstack</i>(&nbsp;)</b>.
<p>
<dt>
<b>VX_UNBREAKABLE</b>
<dd>
 do not allow breakpoint debugging. 
</dl>

<p>
For definitions, see <b>taskLib.h</b>.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./VXWTask.html#top">VXWTask</a></b>

<hr>
<a name="VXWTask::options_1"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWTask::options</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWTask::options</i>(&nbsp;)</strong> - change task options</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS options
    (
    int mask,
    int newOptions
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine changes the execution options of its task.
The only option that can be changed after a task has been created is:
<dl>
<dt>
<b>VX_UNBREAKABLE</b>
<dd>