📄 int8u ostaskdel.htm
字号:
<body background="./系统的服务例程.files/image001.jpg" lang=ZH-CN style='tab-interval:21.0pt;text-justify-trim:punctuation'>
<div class=Section1><b><span lang=EN-US style='font-size:14.0pt;mso-bidi-font-size:
9.0pt;font-family:"Times New Roman";mso-fareast-font-family:宋体;mso-font-kerning:
22.0pt;mso-ansi-language:EN-US;mso-fareast-language:ZH-CN;mso-bidi-language:
AR-SA'><br clear=all style='page-break-before:always'>
</span></b>
<h1><span lang=EN-US style='font-size:14.0pt;mso-bidi-font-size:9.0pt'>INT8U
OSTaskDel(INT8U prio);<o:p></o:p></span></h1>
<p class=Descript><b><span lang=EN-US style='font-family:"Courier New"'>OSTaskDel()</span></b><span
lang=EN-US> allows your application to delete a task by specifying the priority
number of the task to delete.<span style="mso-spacerun: yes"> </span>The
calling task can be deleted by specifying its own priority number or </span><b><span
lang=EN-US style='font-family:"Courier New"'>OS_PRIO_SELF</span></b><span
lang=EN-US> if the task doesn't know its own priority number.<span
style="mso-spacerun: yes"> </span>The deleted task is returned to the
dormant state.<span style="mso-spacerun: yes"> </span>The deleted task
may be created by calling either </span><b><span lang=EN-US style='font-family:
"Courier New"'>OSTaskCreate()</span></b><span lang=EN-US> or </span><b><span
lang=EN-US style='font-family:"Courier New"'>OSTaskCreateExt()</span></b><span
lang=EN-US> to make the task active again.</span></p>
<p class=NewSectionPara><span lang=EN-US><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
<p class=NewSectionPara><b><span lang=EN-US>Arguments<o:p></o:p></span></b></p>
<p class=Descript><b><span lang=EN-US style='font-family:"Courier New"'>prio</span></b><span
lang=EN-US> is the task's priority number to delete.<span style="mso-spacerun:
yes"> </span>You can delete the calling task by passing </span><b><span
lang=EN-US style='font-family:"Courier New"'>OS_PRIO_SELF</span></b><span
lang=EN-US> in which case, the next highest priority task will be executed.</span></p>
<p class=NewSectionPara><span lang=EN-US><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
<p class=NewSectionPara><b><span lang=EN-US>Returned Value<o:p></o:p></span></b></p>
<p class=Descript><b><span lang=EN-US style='font-family:"Courier New"'>OSTaskDel()</span></b><span
lang=EN-US> returns one of the following error codes:</span></p>
<p class=Descript style='margin-left:45.0pt;text-indent:-18.0pt;mso-list:l0 level1 lfo1;
tab-stops:22.5pt 27.0pt list 45.0pt'><![if !supportLists]><span lang=EN-US>1)<span
style='font:7.0pt "Times New Roman"'> </span></span><![endif]><b><span
lang=EN-US style='font-family:"Courier New"'>OS_NO_ERR</span></b><span
lang=EN-US>, if the task didn't delete itself</span></p>
<p class=Descript style='margin-left:45.0pt;text-indent:-18.0pt;mso-list:l0 level1 lfo1;
tab-stops:22.5pt 27.0pt list 45.0pt'><![if !supportLists]><span lang=EN-US>2)<span
style='font:7.0pt "Times New Roman"'> </span></span><![endif]><b><span
lang=EN-US style='font-family:"Courier New"'>OS_TASK_DEL_IDLE</span></b><span
lang=EN-US>, you tried to delete the idle task</span></p>
<p class=Descript style='margin-left:45.0pt;text-indent:-18.0pt;mso-list:l0 level1 lfo1;
tab-stops:22.5pt 27.0pt list 45.0pt'><![if !supportLists]><span lang=EN-US>3)<span
style='font:7.0pt "Times New Roman"'> </span></span><![endif]><b><span
lang=EN-US style='font-family:"Courier New"'>OS_TASK_DEL_ERR</span></b><span
lang=EN-US>, the task to delete does not exist</span></p>
<p class=Descript style='margin-left:45.0pt;text-indent:-18.0pt;mso-list:l0 level1 lfo1;
tab-stops:22.5pt 27.0pt list 45.0pt'><![if !supportLists]><span lang=EN-US>4)<span
style='font:7.0pt "Times New Roman"'> </span></span><![endif]><b><span
lang=EN-US style='font-family:"Courier New"'>OS_PRIO_INVALID,</span></b><span
lang=EN-US> if you specified a task priority higher than </span><b><span
lang=EN-US style='font-family:"Courier New"'>OS_LOWEST_PRIO</span></b></p>
<p class=Descript style='margin-left:45.0pt;text-indent:-18.0pt;mso-list:l0 level1 lfo1;
tab-stops:22.5pt 27.0pt list 45.0pt'><![if !supportLists]><span lang=EN-US>5)<span
style='font:7.0pt "Times New Roman"'> </span></span><![endif]><b><span
lang=EN-US style='font-family:"Courier New"'>OS_TASK_DEL_ISR</span></b><span
lang=EN-US>, you tried to delete a task from an ISR</span></p>
<p class=NewSectionPara><b><span lang=EN-US><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></b></p>
<p class=NewSectionPara><b><span lang=EN-US>Notes/Warnings<o:p></o:p></span></b></p>
<p class=Descript><b><span lang=EN-US style='font-family:"Courier New"'>OSTaskDel()</span></b><span
lang=EN-US> will verify that you are not attempting to delete the µC/OS-II's
idle task.</span></p>
<p class=Descript><span lang=EN-US>You must be careful when you delete a task
that owns resources.<span style="mso-spacerun: yes"> </span>Instead, you
should consider using </span><b><span lang=EN-US style='font-family:"Courier New"'>OSTaskDelReq()</span></b><span
lang=EN-US> which would be a safer approach.</span></p>
<p class=NewSectionPara><span lang=EN-US><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
<p class=NewSectionPara><b><span lang=EN-US>Example<o:p></o:p></span></b></p>
<div style='border:solid #999999 1.5pt;padding:1.0pt 1.0pt 15.0pt 1.0pt;
background:#F2F2F2;mso-shading:windowtext;mso-pattern:gray-5 auto'>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style='mso-tab-count:1'> </span>void TaskX(void *pdata)</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style='mso-tab-count:1'> </span>{</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style='mso-tab-count:1'> </span><span style="mso-spacerun:
yes"> </span>INT8U err;</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style="mso-spacerun: yes"> </span>for (;;) {</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style="mso-spacerun: yes">
</span>. <span style='mso-tab-count:8'> </span></span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style="mso-spacerun: yes">
</span>.</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style='mso-tab-count:1'> </span><span style="mso-spacerun:
yes"> </span><span style='mso-tab-count:1'> </span>err
= OSTaskDel(10);<span style='mso-tab-count:2'> </span>/*
Delete task with priority 10 <span style='mso-tab-count:1'> </span><span
style="mso-spacerun: yes"> </span>*/</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style="mso-spacerun: yes">
</span>if (err == OS_NO_ERR) {</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style="mso-spacerun:
yes">
</span>.<span style="mso-spacerun:
yes">
</span>/* Task was deleted<span style="mso-spacerun:
yes">
</span>*/</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style="mso-spacerun:
yes">
</span>.</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style="mso-spacerun: yes">
</span>}</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style="mso-spacerun: yes">
</span>.<span style='mso-tab-count:8'> </span></span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style="mso-spacerun: yes">
</span>.</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style="mso-spacerun: yes"> </span>}</span></p>
<p class=CodeSeg style='border:none;mso-border-alt:solid #999999 1.5pt;
padding:0cm;mso-padding-alt:1.0pt 1.0pt 15.0pt 1.0pt'><span lang=EN-US><span
style='mso-tab-count:1'> </span>}</span></p>
</div>
<p class=Code><span lang=EN-US style='font-size:9.0pt'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
<p class=Code><span lang=EN-US style='font-size:9.0pt'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
</div>
<span lang=EN-US style='font-size:10.5pt;mso-bidi-font-size:12.0pt;font-family:
"Times New Roman";mso-fareast-font-family:宋体;mso-font-kerning:1.0pt;mso-ansi-language:
EN-US;mso-fareast-language:ZH-CN;mso-bidi-language:AR-SA'><br clear=all
style='page-break-before:always;mso-break-type:section-break'>
</span>
<div class=Section2 style='layout-grid:15.6pt'>
<p class=MsoNormal><span lang=EN-US><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
</div>
</body>
</html>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -