mirror of
https://gitee.com/zlgopen/awtk.git
synced 2024-12-06 05:58:32 +08:00
6.6 KiB
6.6 KiB
action_thread_t
概述
执行action的线程。
每个线程都有一个action queue,可以是共享的queue,也可以是私有的queue。
函数
函数名称 | 说明 |
---|---|
action_thread_create | 创建action_thread对象。 |
action_thread_create_ex | 创建action_thread对象。 |
action_thread_create_with_queue | 创建action_thread对象。 |
action_thread_create_with_queue_ex | 创建action_thread对象。 |
action_thread_destroy | 销毁。 |
action_thread_exec | 让线程执行action。 |
action_thread_set_on_idle | 设置空闲时的回调函数。 |
action_thread_set_on_quit | 设置退出时的回调函数。 |
属性
属性名称 | 类型 | 说明 |
---|---|---|
executed_actions_nr | uint32_t | 已经执行action的个数。 |
queue | waitable_action_queue_t* | action queue。 |
thread | tk_thread_t* | 线程对象。 |
action_thread_create 函数
- 函数功能:
创建action_thread对象。
- 函数原型:
action_thread_t* action_thread_create ();
- 参数说明:
参数 | 类型 | 说明 |
---|---|---|
返回值 | action_thread_t* | action_thread对象。 |
action_thread_create_ex 函数
- 函数功能:
创建action_thread对象。
- 函数原型:
action_thread_t* action_thread_create_ex (const char* name, uint32_t stack_size, tk_thread_priority_t priority);
- 参数说明:
参数 | 类型 | 说明 |
---|---|---|
返回值 | action_thread_t* | action_thread对象。 |
name | const char* | 名称。 |
stack_size | uint32_t | 栈的大小。 |
priority | tk_thread_priority_t | 优先级。 |
action_thread_create_with_queue 函数
- 函数功能:
创建action_thread对象。
- 函数原型:
action_thread_t* action_thread_create_with_queue (waitable_action_queue_t* queue);
- 参数说明:
参数 | 类型 | 说明 |
---|---|---|
返回值 | action_thread_t* | action_thread对象。 |
queue | waitable_action_queue_t* | queue对象。 |
action_thread_create_with_queue_ex 函数
- 函数功能:
创建action_thread对象。
- 函数原型:
action_thread_t* action_thread_create_with_queue_ex (waitable_action_queue_t* queue, const char* name, uint32_t stack_size, tk_thread_priority_t priority);
- 参数说明:
参数 | 类型 | 说明 |
---|---|---|
返回值 | action_thread_t* | action_thread对象。 |
queue | waitable_action_queue_t* | queue对象。 |
name | const char* | 名称。 |
stack_size | uint32_t | 栈的大小。 |
priority | tk_thread_priority_t | 优先级。 |
action_thread_destroy 函数
- 函数功能:
销毁。
- 函数原型:
ret_t action_thread_destroy (action_thread_t* thread);
- 参数说明:
参数 | 类型 | 说明 |
---|---|---|
返回值 | ret_t | 返回RET_OK表示成功,否则表示失败。 |
thread | action_thread_t* | action_thread对象。 |
action_thread_exec 函数
- 函数功能:
让线程执行action。
- 函数原型:
ret_t action_thread_exec (action_thread_t* thread, qaction_t* action);
- 参数说明:
参数 | 类型 | 说明 |
---|---|---|
返回值 | ret_t | 返回RET_OK表示成功,否则表示失败。 |
thread | action_thread_t* | action_thread对象。 |
action | qaction_t* | action对象。 |
action_thread_set_on_idle 函数
- 函数功能:
设置空闲时的回调函数。
- 函数原型:
ret_t action_thread_set_on_idle (action_thread_t* thread, action_thread_on_idle_t on_idle, void* ctx);
- 参数说明:
参数 | 类型 | 说明 |
---|---|---|
返回值 | ret_t | 返回RET_OK表示成功,否则表示失败。 |
thread | action_thread_t* | action_thread对象。 |
on_idle | action_thread_on_idle_t | 空闲时的回调函数。 |
ctx | void* | 回调函数的上下文。 |
action_thread_set_on_quit 函数
- 函数功能:
设置退出时的回调函数。
- 函数原型:
ret_t action_thread_set_on_quit (action_thread_t* thread, action_thread_on_quit_t on_quit, void* ctx);
- 参数说明:
参数 | 类型 | 说明 |
---|---|---|
返回值 | ret_t | 返回RET_OK表示成功,否则表示失败。 |
thread | action_thread_t* | action_thread对象。 |
on_quit | action_thread_on_quit_t | 退出时的回调函数。 |
ctx | void* | 回调函数的上下文。 |
executed_actions_nr 属性
已经执行action的个数。
- 类型:uint32_t
特性 | 是否支持 |
---|---|
可直接读取 | 是 |
可直接修改 | 否 |
queue 属性
action queue。
- 类型:waitable_action_queue_t*
特性 | 是否支持 |
---|---|
可直接读取 | 是 |
可直接修改 | 否 |
thread 属性
线程对象。
- 类型:tk_thread_t*
特性 | 是否支持 |
---|---|
可直接读取 | 是 |
可直接修改 | 否 |