Zephyr开发指南——API状态和指南（API术语）

API术语

以下术语可以用作速记API标记，以表示允许的调用上下文(线程、ISR、预内核)、调用对当前线程状态的影响以及其他行为特征。

reschedule

如果执行该函数达到了一个重新调度点

sleep

如果执行该函数会导致调用线程休眠

no-wait

如果该函数的一个参数可以阻止调用线程尝试休眠

isr-ok

如果函数可以安全调用，并且无论从中断还是线程上下文调用，都将具有其指定的效果

pre-kernel-ok

如果该函数可以在内核被完全初始化之前被安全地调用，并且在从该上下文调用时将具有其指定的效果。

async

如果函数可能在其初始化的操作完成之前返回（即，函数返回和操作完成是异步的）

supervisor

如果调用线程必须具有管理员权限才能执行该函数

关于每个属性的行为影响的详细信息见下面的部分。

reschedule

重新调度属性用于可在其执行过程中到达重新调度点的函数。

详细信息

此属性的意义在于，当线程调用重新调度函数时，由于高优先级线程，该线程可能被挂起。暂停是否实际发生取决于与重新调度点相关联的操作，以及调用线程和准备队列的头的相对优先级。

请注意，在时间限制或重新安排从中断中执行的点的情况下，任何线程都可以在任何功能中挂起。

没有重新调度的函数可以从线程或中断上下文中调用。

可以从线程上下文调用。

可以从中断上下文中调用被重新调度但不是睡眠的函数。

sleep

休眠属性用于可