API术语
以下术语可以用作速记API标记,以表示允许的调用上下文(线程、ISR、预内核)、调用对当前线程状态的影响以及其他行为特征。
reschedule
如果执行该函数达到了一个重新调度点
sleep
如果执行该函数会导致调用线程休眠
no-wait
如果该函数的一个参数可以阻止调用线程尝试休眠
isr-ok
如果函数可以安全调用,并且无论从中断还是线程上下文调用,都将具有其指定的效果
pre-kernel-ok
如果该函数可以在内核被完全初始化之前被安全地调用,并且在从该上下文调用时将具有其指定的效果。
async
如果函数可能在其初始化的操作完成之前返回(即,函数返回和操作完成是异步的)
supervisor
如果调用线程必须具有管理员权限才能执行该函数
关于每个属性的行为影响的详细信息见下面的部分。
reschedule
重新调度属性用于可在其执行过程中到达重新调度点的函数。
详细信息
此属性的意义在于,当线程调用重新调度函数时,由于高优先级线程,该线程可能被挂起。暂停是否实际发生取决于与重新调度点相关联的操作,以及调用线程和准备队列的头的相对优先级。
请注意,在时间限制或重新安排从中断中执行的点的情况下,任何线程都可以在任何功能中挂起。
没有重新调度的函数可以从线程或中断上下文中调用。
可以从线程上下文调用。
可以从中断上下文中调用被重新调度但不是睡眠的函数。
sleep
休眠属性用于可