trglib.html

vxworks相关论文

the type of action associated with the trigger (none, func, lib).
<p>
<dt>
<i>actionFunc</i>
<dd>

the action associated with the trigger (the function).
<p>
<dt>
<i>actionDef</i>
<dd>

the indicator of whether the action can be deferred (deferred is the default).
<p>
<dt>
<i>actionArg</i>
<dd>
 the argument passed to the function, if any. 
</dl>

<p>

Attempting to call trgAdd whilst triggering is enabled is not allowed
and will return NULL.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
<b>TRIGGER_ID</b>, or NULL if either the trigger ID can not be allocated,
or if called whilst triggering is enabled.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./trgLib.html#top">trgLib</a></b>, <b><i><a href="./trgLib.html#trgDelete">trgDelete</a></i>(&nbsp;)</b>

<hr>
<a name="trgDelete"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>trgDelete</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>trgDelete</i>(&nbsp;)</strong> - delete a trigger from the trigger list</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS trgDelete
    (
    TRIGGER_ID trgId
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine deletes a trigger by removing it from the trigger list.  It
also checks that no other triggers are still active.  If there are no
active triggers and triggering is still on, it turns triggering off.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK, or ERROR if the trigger is not found.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./trgLib.html#top">trgLib</a></b>, <b><i><a href="./trgLib.html#trgAdd">trgAdd</a></i>(&nbsp;)</b>

<hr>
<a name="trgOn"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>trgOn</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>trgOn</i>(&nbsp;)</strong> - set triggering on</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>

STATUS trgOn (void)</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine activates triggering.  From this time on, any time an event
point is hit, a check for the presence of possible triggers is performed.
Start triggering only when needed since some overhead is introduced.
<p>
</blockquote><h4>NOTE</h4><blockquote><p>
If <b><i><a href="./trgLib.html#trgOn">trgOn</a></i>(&nbsp;)</b> is called when there are no triggers in the trigger list, it
immediately sets triggering off again.  If <b><i><a href="./trgLib.html#trgOn">trgOn</a></i>(&nbsp;)</b> is called with at least
one trigger in the list, triggering begins.  Triggers should not be 
added to the list while triggering is on since this can create
instability.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK or ERROR.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./trgLib.html#top">trgLib</a></b>, <b><i><a href="./trgLib.html#trgOff">trgOff</a></i>(&nbsp;)</b>

<hr>
<a name="trgOff"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>trgOff</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>trgOff</i>(&nbsp;)</strong> - set triggering off</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>

void trgOff (void)</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine turns triggering off. From this time on, when an event point 
is hit, no search on triggers is performed.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./trgLib.html#top">trgLib</a></b>, <b><i><a href="./trgLib.html#trgOn">trgOn</a></i>(&nbsp;)</b>

<hr>
<a name="trgEnable"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>trgEnable</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>trgEnable</i>(&nbsp;)</strong> - enable a trigger</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS trgEnable
    (
    TRIGGER_ID trgId
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine enables a trigger that has been created with <b><i><a href="./trgLib.html#trgAdd">trgAdd</a></i>(&nbsp;)</b>. A counter
is incremented to keep track of the total number of enabled triggers so that 
<b><i><a href="./trgLib.html#trgDisable">trgDisable</a></i>(&nbsp;)</b> knows when to set triggering off. If the maximum number of 
enabled triggers is reached, an error is returned. 
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK, or ERROR if the trigger ID is not found or if the maximum
number of triggers has already been enabled.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./trgLib.html#top">trgLib</a></b>, <b><i><a href="./trgLib.html#trgDisable">trgDisable</a></i>(&nbsp;)</b>

<hr>
<a name="trgDisable"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>trgDisable</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>trgDisable</i>(&nbsp;)</strong> - turn a trigger off</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS trgDisable
    (
    TRIGGER_ID trgId
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine disables a trigger. It also checks to see if there are triggers
still active.  If this is the last active trigger it sets triggering off.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK, or ERROR if the trigger ID is not found.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./trgLib.html#top">trgLib</a></b>, <b><i><a href="./trgLib.html#trgEnable">trgEnable</a></i>(&nbsp;)</b>

<hr>
<a name="trgChainSet"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>trgChainSet</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>trgChainSet</i>(&nbsp;)</strong> - chains two triggers</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS trgChainSet
    (
    TRIGGER_ID fromId,
    TRIGGER_ID toId
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine chains two triggers together.  When the first trigger fires, it
calls <b><i><a href="./trgLib.html#trgEnable">trgEnable</a></i>(&nbsp;)</b> for the second trigger.  The second trigger must be created
disabled in order to maintain the correct sequence.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK or ERROR.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./trgLib.html#top">trgLib</a></b>, <b><i><a href="./trgLib.html#trgEnable">trgEnable</a></i>(&nbsp;)</b>

<hr>
<a name="trgEvent"></a>
<p align=right>
<a href="rtnIndex.html"><i>Libraries :  Routines</i></a></p>

</blockquote><h1><i>trgEvent</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>trgEvent</i>(&nbsp;)</strong> - trigger a user-defined event </p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>void trgEvent
    (
    event_t evtId /* event */
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine triggers a user event. A trigger must exist and triggering must 
have been started with <b><i><a href="./trgLib.html#trgOn">trgOn</a></i>(&nbsp;)</b> or from the triggering GUI to use this routine.  
The <i>evtId</i> should be in the range 40000-65535. 
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./trgLib.html#top">trgLib</a></b>, <b><a href="./dbgLib.html#top">dbgLib</a></b>, <b><i><a href="./dbgLib.html#e">e</a></i>(&nbsp;)</b>
<p>

INTERNAL
</body>
</html>