HTL_initialize_library

接口定义

int HTL_initialize_library(void);

描述

HTL_initialize_library()用于初始化HTL执行环境。

• 如果HTL尚未初始化，HTL_init_library()的第一个调用者将成为主执行器上运行的主工作单元。
• 如果HTL线程已初始化，再调用初始化函数HTL_initialize_library()，HTL将以原子方式递增引用计数。即使HTL线程已经初始化，该函数也会返回HTL_THREAD_SUCCESS。

HTL使用后须由HTL_finalize_library()释放。HTL线程可以以嵌套的方式多次初始化和去初始化，但HTL_finalize_library()与HTL_initialize_library()的调用者必须在同一嵌套级别上。释放HTL线程后，可以重新初始化HTL线程。

HTL-PThreads开发模式无需调用初始化接口。

参数

不涉及。

返回值

• HTL_THREAD_SUCCESS：成功。
• 其他：失败。见错误码定义。