vTaskDelete
[任务创建]

task. h

void vTaskDelete( TaskHandle_t xTask );

INCLUDE_vTaskDelete 必须定义为 1 才能使用此函数。详情请参阅 RTOS 配置文档。

此函数的作用为从 RTOS 内核管理中移除任务。被删除的任务将从所有的就绪、阻塞、挂起和事件的列表中移除。

请注意，空闲任务负责从已删除任务中释放 RTOS 内核分配的内存。因此，重要的是，如果您的应用程序调用了 vTaskDelete ()，空闲任务不会失去微控制器处理时间。任务代码分配的内存不会自动释放，并且应在删除任务之前释放。

请参阅演示应用程序文件 death. c，获取使用 vTaskDelete () 的代码示例。

参数：

xTask

待删除的任务的句柄。传递 NULL 将导致调用任务被删除。

用法示例：


 void vOtherFunction( void )
 {
 TaskHandle_t xHandle = NULL;

     // Create the task, storing the handle.
     xTaskCreate( vTaskCode, "NAME", STACK_SIZE, NULL, tskIDLE_PRIORITY, &xHandle );

     // Use the handle to delete the task.
     if( xHandle != NULL )
     {
         vTaskDelete( xHandle );
     }
 }