B_QuRT_User_Guide(4)

3.9 qurt_thread_attr_set_tcb_partition()

3.9.1 功能文档

3.9.1.1 static void qurt_thread_attr_set_tcb_partition (qurt_thread_attr_t ∗ attr, unsigned char tcb_partition )

设置线程 TCB 分区属性。 指定分配线程的线程控制块 (TCB) 的内存类型。 在 RAM 或 TCM/LPM 中分配 TCB。

相关数据类型
qurt_thread_attr_t

参数

in,out	attr	指向线程属性结构的指针
in	tcb_partition	TCB 分区,值： 0 – TCB 驻留在 RAM 中 1 – TCB 位于 TCM/LCM 中

返回值
None.

依赖关系
None.

3.10 qurt_thread_attr_set_timetest_id()

3.10.1 功能文档

3.10.1.1 static void qurt_thread_attr_set_timetest_id ( qurt_thread_attr_t ∗ attr,unsigned short timetest_id )

设置线程时间测试属性。
指定线程使用的时间测试标识符。
Timetest 标识符用于在调试或分析期间标识线程。

注意：Timetest 标识符不同于内核生成的用于在 API 线程操作中指定线程的线程标识符。

相关数据类型
qurt_thread_attr_t

参数

in,out	attr	指向线程属性结构的指针
in	timetest_id	时间测试标识符值

返回值
None.

依赖关系
None.

3.11 qurt_thread_create()

3.11.1 功能文档

3.11.1.1 int qurt_thread_create ( qurt_thread_t ∗ thread_id, qurt_thread_attr_t ∗ attr,void(∗)(void ∗) entrypoint, void ∗ arg )

创建具有指定属性的线程，并使其可执行。
注意：如果线程属性中指定的硬件线程集对目标处理器版本无效，则此函数将失败（并产生错误结果）。

相关数据类型
qurt_thread_t
qurt_thread_attr_t

参数

out	thread_id	如果线程已成功创建，则返回指向线程标识符的指针。
in	attr	指向已初始化线程属性结构的指针，该结构指定已创建线程的属性。
in	entrypoint	C函数指针，指定线程的主函数。
in	arg	指向特定于线程的参数结构的指针。

返回值
QURT_EOK – 已创建线程。
QURT_EFAILED – 未创建线程。

依赖关系
None.

3.12 qurt_thread_exit()

3.12.1 功能文档

3.12.1.1 void qurt_thread_exit ( int status )

停止当前线程并唤醒任何加入它的线程，然后销毁停止的线程。
任何在当前线程上挂起的线程（通过执行线程连接——第 3.19.1.1 节）都会被唤醒并传递一个用户定义的状态值，指示停止线程的状态。

注意：必须在线程的上下文中调用exit才能停止。

参数

in	status	用户定义的线程退出状态值。

返回值
None.

依赖关系
None.

3.13 qurt_thread_get_anysignal()

3.13.1 功能文档

3.13.1.1 unsigned int qurt_thread_get_anysignal ( void )

获取当前线程的信号。 返回当前线程的 RTOS 分配信号。
QuRT 为每个线程分配一个信号以支持线程之间的通信。

返回值
信号对象地址——分配给当前线程的任何信号对象。

依赖关系
None.

3.14 qurt_thread_get_id()

3.14.1 功能文档

3.14.1.1 qurt_thread_t qurt_thread_get_id ( void )

获取当前线程的标识符。
返回当前线程的线程标识符。

返回值
线程标识符——当前线程的标识符。

依赖关系
None.

3.15 qurt_thread_get_l2cache_partition()

3.15.1 功能文档

3.15.1.1 qurt_cache_partition_t qurt_thread_get_l2cache_partition ( void )

返回分配给调用者线程的 L2 缓存分区的当前值。

返回值
数据类型 qurt_cache_partition_t 的值。

依赖关系
None.

3.16 qurt_thread_get_name()

3.16.1 功能文档

3.16.1.1 void qurt_thread_get_name ( char ∗ name, unsigned char max_len )

获取当前线程的线程名。
返回当前线程的线程名称。 线程名称作为线程属性分配给线程（第 3 节）。 它们用于在调试或分析期间识别线程。

参数

out	name	指向字符串的指针，该字符串指定存储返回的线程名称的地址。
in	max_len	可以返回的字符串的最大长度。

返回值
None.

依赖关系
None.