os_task_self

所属模块:任务管理 | 类型:任务标识获取函数

API Metadata

函数ID:os_task_self
模块:task
类型:task identity
嵌套深度:1

函数简介

os_task_self 用于获取当前正在运行的任务ID。

该接口提供任务自识别能力,使任务能够获取自身在系统中的唯一标识。

常用于任务间通信、调试以及资源绑定等场景。

函数原型

u8 os_task_self(void);

参数说明

无参数。

返回值

当前运行任务的ID(0~OS_PROCESS_MAX+1)

源码实现

/*------------------------------------------------------------------------ | FILE DESCRIPTION | ------------------------------------------------------------------------*/ /*------------------------------------------------------------------------ | - File name : task_self.c | - Author : 谭舒 | - Update date : 2026-09-19 | - Copyright(C) : 2026 HRTOS. All rights reserved. ------------------------------------------------------------------------*/ /*------------------------------------------------------------------------ | INCLUDES | ------------------------------------------------------------------------*/ #include "hrtos_internal.h" /*------------------------------------------------------------------------ | API FUNCTIONS | ------------------------------------------------------------------------*/ /** * @brief 获取当前运行任务的任务编号。 * * @param[in] None * * @return 当前任务编号。 */ u8 os_task_self(void)//获取当前任务ID { return OS_CURRENT_TASK; } /*------------------------------------------------------------------------ | END OF FILE: task_self.c | ------------------------------------------------------------------------*/

使用示例

void demo_self() { u8 id; id = os_task_self(); // 当前任务ID }

注意事项

返回值依赖调度器当前上下文,仅在任务运行上下文中有效。 中断环境下调用可能返回未定义结果。

相关推荐