os_task_set_next

所属模块:调度器 | 类型:强制调度控制函数

API Metadata

函数ID:os_task_set_next
模块:scheduler
类型:force context switch
嵌套深度:1

函数简介

os_task_set_next 用于强制指定下一次运行的任务,并立即触发系统调度。

该接口会打断当前调度流程,直接修改当前任务与下一个任务的执行关系。

由于会绕过正常调度策略,该接口仅建议用于调试或特殊控制场景。

函数原型

char os_task_set_next(unsigned char id);

参数说明

参数 说明
id 目标任务ID(0~OS_PROCESS_MAX+1)

返回值

1:切换成功
-1:参数非法或任务不可运行

源码实现

/*------------------------------------------------------------------------ | FILE DESCRIPTION | ------------------------------------------------------------------------*/ /*------------------------------------------------------------------------ | - File name : task_scheduler.c | - Author : 谭舒 | - Update date : 2026-09-19 | - Copyright(C) : 2026 HRTOS. All rights reserved. ------------------------------------------------------------------------*/ /*------------------------------------------------------------------------ | INCLUDES | ------------------------------------------------------------------------*/ #include "hrtos_internal.h" /*------------------------------------------------------------------------ | API FUNCTIONS | ------------------------------------------------------------------------*/ /** * @brief 指定下一次调度运行的任务。 * * @param[in] id 下一次调度运行的任务编号。 * * @return 操作结果。 * @retval 1 下一运行任务设置成功。 * @retval -1 任务编号无效、任务未处于就绪状态或当前调度请求已设置。 * * @note 该接口用于指定系统下一次调度时运行的任务。 * 设置成功后记录当前任务及目标任务,并请求系统通过 Timer0 中断执行调度。 * 每次调度周期仅允许设置一次下一运行任务。 * 该接口会改变系统正常调度选择结果,应谨慎使用。 */ char os_task_set_next(unsigned char id) //指定下个运行的进程(终止调度,强行切换),ID为任务编号;建议未来删除或限制 { if(id>OS_PROCESS_MAX+1)//任务序号不符合系统要求 { return -1; } if(id < OS_PROCESS_MAX) { if((OS_PROCESS_OK[id] & 0x01)==0)//非就绪状态 { return -1; } } if( id==OS_PROCESS_MAX ) { if(!OS_KUAI_PROCESS_A)//非就绪状态 { return -1; } } if( id==OS_PROCESS_MAX+1 ) { if(!OS_KUAI_PROCESS_B)//非就绪状态 { return -1; } } if(OS_JINCHENG_CUNCHU==0)//只能指定一次,执行后内核将OS_JINCHENG_CUNCHU清零 { OS_JINCHENG_CUNCHU=1;//下一个调度不会运行 OS_PREV_TASK=OS_CURRENT_TASK;//将本次运行任务进行保存 OS_CURRENT_TASK=id;//将要下一次执行的任务进行保存 OS_SCHED_REASON=1;//调度触发位 TF0=1;//T0中断 return 1; } return -1; } /*------------------------------------------------------------------------ | END OF FILE: task_scheduler.c | ------------------------------------------------------------------------*/

使用示例

void debug_switch() { os_task_set_next(2); }

注意事项

该接口会绕过正常调度逻辑,仅允许执行一次切换控制。 多次调用可能导致调度状态不一致。

相关推荐