os_idle_hook_register

所属模块:系统内核 | 类型:Idle Hook注册函数

API Metadata

函数ID:os_idle_hook_register
模块:kernel
类型:idle hook register
嵌套深度:1

函数简介

:contentReference[oaicite:0]{index=0} 用于注册系统空闲任务(Idle Task)的回调函数。 当系统没有可运行任务时,将自动执行用户注册的 hook 函数。

该机制通常用于低功耗处理、后台维护、状态统计等非实时关键操作,是系统扩展能力的重要接口之一。

函数原型

void os_idle_hook_register(void (*hook)(void));

参数说明

参数 说明
hook 用户注册的回调函数指针,在系统 Idle 状态时被周期性调用

返回值

无返回值。

源码实现

void os_idle_hook_register(void (*hook)(void)) { g_idle_hook = hook; }

使用示例

void my_idle_task(void) { // 空闲状态下执行低优先级任务 } void app_init(void) { os_idle_hook_register(my_idle_task); }

注意事项

Idle Hook 会在系统空闲时频繁执行,不应在其中进行阻塞操作或长时间计算,否则可能影响实时任务调度性能。

相关推荐