awtk/docs/manual/tk_cond_var_t.md

90 lines
2.2 KiB
Markdown
Raw Normal View History

2019-07-04 10:05:59 +08:00
## tk\_cond\_var\_t
### 概述
2019-11-15 11:33:43 +08:00
简化版的条件变量。
2019-07-04 10:05:59 +08:00
----------------------------------
### 函数
<p id="tk_cond_var_t_methods">
| 函数名称 | 说明 |
| -------- | ------------ |
| <a href="#tk_cond_var_t_tk_cond_var_awake">tk\_cond\_var\_awake</a> | 唤醒。 |
| <a href="#tk_cond_var_t_tk_cond_var_create">tk\_cond\_var\_create</a> | 创建cond_var。 |
| <a href="#tk_cond_var_t_tk_cond_var_destroy">tk\_cond\_var\_destroy</a> | 销毁cond_var对象。 |
| <a href="#tk_cond_var_t_tk_cond_var_wait">tk\_cond\_var\_wait</a> | 等待。 |
#### tk\_cond\_var\_awake 函数
-----------------------
* 函数功能:
2019-11-15 11:33:43 +08:00
> <p id="tk_cond_var_t_tk_cond_var_awake">唤醒。
2019-10-16 09:02:32 +08:00
2019-07-04 10:05:59 +08:00
* 函数原型:
```
ret_t tk_cond_var_awake (tk_cond_var_t* cond_var);
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功否则表示失败。 |
| cond\_var | tk\_cond\_var\_t* | cond\_var对象。 |
#### tk\_cond\_var\_create 函数
-----------------------
* 函数功能:
2019-11-15 11:33:43 +08:00
> <p id="tk_cond_var_t_tk_cond_var_create">创建cond_var。
2019-10-16 09:02:32 +08:00
2019-07-04 10:05:59 +08:00
* 函数原型:
```
tk_cond_var_t* tk_cond_var_create ();
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | tk\_cond\_var\_t* | cond\_var对象。 |
#### tk\_cond\_var\_destroy 函数
-----------------------
* 函数功能:
2019-11-15 11:33:43 +08:00
> <p id="tk_cond_var_t_tk_cond_var_destroy">销毁cond_var对象。
2019-10-16 09:02:32 +08:00
2019-07-04 10:05:59 +08:00
* 函数原型:
```
ret_t tk_cond_var_destroy (tk_cond_var_t* cond_var);
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功否则表示失败。 |
| cond\_var | tk\_cond\_var\_t* | cond\_var对象。 |
#### tk\_cond\_var\_wait 函数
-----------------------
* 函数功能:
2019-11-15 11:33:43 +08:00
> <p id="tk_cond_var_t_tk_cond_var_wait">等待。
2019-10-16 09:02:32 +08:00
2019-07-04 10:05:59 +08:00
* 函数原型:
```
2023-12-26 20:05:44 +08:00
ret_t tk_cond_var_wait (tk_cond_var_t* cond_var, uint32_t timeout);
2019-07-04 10:05:59 +08:00
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功否则表示失败。 |
| cond\_var | tk\_cond\_var\_t* | cond\_var对象。 |
2023-12-26 20:05:44 +08:00
| timeout | uint32\_t | 最长等待时间(毫秒)。 |