117 lines
		
	
	
		
			5.1 KiB
		
	
	
	
		
			HTML
		
	
	
	
	
	
			
		
		
	
	
			117 lines
		
	
	
		
			5.1 KiB
		
	
	
	
		
			HTML
		
	
	
	
	
	
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 | 
						|
<html xmlns="http://www.w3.org/1999/xhtml">
 | 
						|
<head>
 | 
						|
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
 | 
						|
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
 | 
						|
<meta name="generator" content="Doxygen 1.8.20"/>
 | 
						|
<meta name="viewport" content="width=device-width, initial-scale=1"/>
 | 
						|
<title>Labor04: vTaskSuspend</title>
 | 
						|
<link href="tabs.css" rel="stylesheet" type="text/css"/>
 | 
						|
<script type="text/javascript" src="jquery.js"></script>
 | 
						|
<script type="text/javascript" src="dynsections.js"></script>
 | 
						|
<link href="navtree.css" rel="stylesheet" type="text/css"/>
 | 
						|
<script type="text/javascript" src="resize.js"></script>
 | 
						|
<script type="text/javascript" src="navtreedata.js"></script>
 | 
						|
<script type="text/javascript" src="navtree.js"></script>
 | 
						|
<link href="search/search.css" rel="stylesheet" type="text/css"/>
 | 
						|
<script type="text/javascript" src="search/searchdata.js"></script>
 | 
						|
<script type="text/javascript" src="search/search.js"></script>
 | 
						|
<link href="doxygen.css" rel="stylesheet" type="text/css" />
 | 
						|
</head>
 | 
						|
<body>
 | 
						|
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
 | 
						|
<div id="titlearea">
 | 
						|
<table cellspacing="0" cellpadding="0">
 | 
						|
 <tbody>
 | 
						|
 <tr style="height: 56px;">
 | 
						|
  <td id="projectalign" style="padding-left: 0.5em;">
 | 
						|
   <div id="projectname">Labor04
 | 
						|
   </div>
 | 
						|
  </td>
 | 
						|
 </tr>
 | 
						|
 </tbody>
 | 
						|
</table>
 | 
						|
</div>
 | 
						|
<!-- end header part -->
 | 
						|
<!-- Generated by Doxygen 1.8.20 -->
 | 
						|
<script type="text/javascript">
 | 
						|
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */
 | 
						|
var searchBox = new SearchBox("searchBox", "search",false,'Search');
 | 
						|
/* @license-end */
 | 
						|
</script>
 | 
						|
<script type="text/javascript" src="menudata.js"></script>
 | 
						|
<script type="text/javascript" src="menu.js"></script>
 | 
						|
<script type="text/javascript">
 | 
						|
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */
 | 
						|
$(function() {
 | 
						|
  initMenu('',true,false,'search.php','Search');
 | 
						|
  $(document).ready(function() { init_search(); });
 | 
						|
});
 | 
						|
/* @license-end */</script>
 | 
						|
<div id="main-nav"></div>
 | 
						|
</div><!-- top -->
 | 
						|
<div id="side-nav" class="ui-resizable side-nav-resizable">
 | 
						|
  <div id="nav-tree">
 | 
						|
    <div id="nav-tree-contents">
 | 
						|
      <div id="nav-sync" class="sync"></div>
 | 
						|
    </div>
 | 
						|
  </div>
 | 
						|
  <div id="splitbar" style="-moz-user-select:none;" 
 | 
						|
       class="ui-resizable-handle">
 | 
						|
  </div>
 | 
						|
</div>
 | 
						|
<script type="text/javascript">
 | 
						|
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */
 | 
						|
$(document).ready(function(){initNavTree('group__v_task_suspend.html',''); initResizable(); });
 | 
						|
/* @license-end */
 | 
						|
</script>
 | 
						|
<div id="doc-content">
 | 
						|
<!-- window showing the filter options -->
 | 
						|
<div id="MSearchSelectWindow"
 | 
						|
     onmouseover="return searchBox.OnSearchSelectShow()"
 | 
						|
     onmouseout="return searchBox.OnSearchSelectHide()"
 | 
						|
     onkeydown="return searchBox.OnSearchSelectKey(event)">
 | 
						|
</div>
 | 
						|
 | 
						|
<!-- iframe showing the search results (closed by default) -->
 | 
						|
<div id="MSearchResultsWindow">
 | 
						|
<iframe src="javascript:void(0)" frameborder="0" 
 | 
						|
        name="MSearchResults" id="MSearchResults">
 | 
						|
</iframe>
 | 
						|
</div>
 | 
						|
 | 
						|
<div class="header">
 | 
						|
  <div class="headertitle">
 | 
						|
<div class="title">vTaskSuspend</div>  </div>
 | 
						|
</div><!--header-->
 | 
						|
<div class="contents">
 | 
						|
<p>task. h </p><pre>void <a class="el" href="task_8h.html#a84d4e660b04630be2939d91b3c2412f8">vTaskSuspend( TaskHandle_t xTaskToSuspend )</a>;</pre><p>INCLUDE_vTaskSuspend must be defined as 1 for this function to be available. See the configuration section for more information.</p>
 | 
						|
<p>Suspend any task. When suspended a task will never get any microcontroller processing time, no matter what its priority.</p>
 | 
						|
<p>Calls to vTaskSuspend are not accumulative - i.e. calling vTaskSuspend () twice on the same task still only requires one call to vTaskResume () to ready the suspended task.</p>
 | 
						|
<dl class="params"><dt>Parameters</dt><dd>
 | 
						|
  <table class="params">
 | 
						|
    <tr><td class="paramname">xTaskToSuspend</td><td>Handle to the task being suspended. Passing a NULL handle will cause the calling task to be suspended.</td></tr>
 | 
						|
  </table>
 | 
						|
  </dd>
 | 
						|
</dl>
 | 
						|
<p>Example usage: </p><pre>
 | 
						|
void vAFunction( void )
 | 
						|
{
 | 
						|
TaskHandle_t xHandle;</pre><pre>    // Create a task, storing the handle.
 | 
						|
    xTaskCreate( vTaskCode, "NAME", STACK_SIZE, NULL, tskIDLE_PRIORITY, &xHandle );</pre><pre>    // ...</pre><pre>    // Use the handle to suspend the created task.
 | 
						|
    vTaskSuspend( xHandle );</pre><pre>    // ...</pre><pre>    // The created task will not run during this period, unless
 | 
						|
    // another task calls vTaskResume( xHandle ).</pre><pre>    //...</pre><pre>    // Suspend ourselves.
 | 
						|
    vTaskSuspend( NULL );</pre><pre>    // We cannot get here unless another task calls vTaskResume
 | 
						|
    // with our handle as the parameter.
 | 
						|
}
 | 
						|
  </pre> </div><!-- contents -->
 | 
						|
</div><!-- doc-content -->
 | 
						|
<!-- start footer part -->
 | 
						|
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
 | 
						|
  <ul>
 | 
						|
    <li class="footer">Generated by <a href="http://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.8.20 </li>
 | 
						|
  </ul>
 | 
						|
</div>
 | 
						|
</body>
 | 
						|
</html>
 |