B_QuRT_User_Guide(24)

15.3 qurt_timer_attr_get_remaining()

15.3.1 功能文档

15.3.1.1 void qurt_timer_attr_get_remaining ( qurt_timer_attr_t ∗ attr, qurt_timer_duration_t ∗ remaining )

从指定的计时器属性结构中获取计时器remaining持续时间。
计时器remaining持续时间表示（以微秒为单位）在相应计时器上生成下一个计时器事件之前remaining的时间。 在大多数情况下，此函数假定计时器属性结构是通过调用 qurt_timer_get_attr() 获得的。
注意：此属性是只读的，因此没有为其定义设置操作。

相关数据类型
qurt_timer_attr_t
qurt_timer_duration_t
参数

in	attr	指向计时器属性对象的指针。
out	remaining	指向remaining时间的目标变量的指针。

返回值
None.

依赖项
None.

15.4 qurt_timer_attr_get_type()

15.4.1 功能文档

15.4.1.1 void qurt_timer_attr_get_type ( qurt_timer_attr_t ∗ attr, qurt_timer_type_t ∗type )

从指定的计时器属性结构中获取计时器类型。

相关数据类型
qurt_timer_attr_t
qurt_timer_type_t

参数

in	attr	指向计时器属性结构的指针。
out	remaining	指向计时器类型的目标变量的指针。

返回值
None.

依赖项
None.

15.5 qurt_timer_attr_init()

15.5.1 功能文档

15.5.1.1 void qurt_timer_attr_init ( qurt_timer_attr_t ∗ attr )

使用默认属性值初始化指定的计时器属性结构：

• 定时器持续时间 – QURT_TIMER_DEFAULT_DURATION（第 15 节）
• 定时器类型 – QURT_TIMER_ONESHOT
• 定时器组 – QURT_TIMER_DEFAULT_GROUP

相关数据类型
qurt_timer_attr_t

参数

in,out	attr	指向计时器属性的目标结构的指针。

返回值
None.

依赖项
None.

15.6 qurt_timer_attr_set_duration()

15.6.1 功能文档

15.6.1.1 void qurt_timer_attr_set_duration ( qurt_timer_attr_t ∗ attr, qurt_timer_duration_t duration )

在指定的计时器属性结构中设置计时器持续时间。
计时器持续时间指定计时器对象的创建和相应计时器事件的生成之间的时间间隔（以微秒为单位）。
定时器持续时间值必须在 QURT_TIMER_MIN_DURATION 和 QURT_TIMER_MAX_DURATION 之间（第 15 节）。 否则，设置操作将被忽略。
注意：最长计时器持续时间为 36 小时。

相关数据类型
qurt_timer_attr_t
qurt_timer_duration_t

参数

in,out	attr	指向计时器属性结构的指针。
in	duration	计时器持续时间（以微秒为单位）。 有效范围是 QURT_TIMER_MIN_DURATION 到 QURT_TIMER_MAX_DURATION。

返回值
None.

依赖项
None.

15.7 qurt_timer_attr_set_expiry()

15.7.1 功能文档

15.7.1.1 void qurt_timer_attr_set_expiry ( qurt_timer_attr_t ∗ attr, qurt_timer_time_t time )

在指定的计时器属性结构中设置绝对到期时间。
计时器到期指定相应计时器事件生成的绝对时间（以微秒为单位）。
计时器到期时间与系统首次开始执行的时间有关。

相关数据类型
qurt_timer_attr_t
qurt_timer_time_t

参数

in,out	attr	指向计时器属性结构的指针。
in	time	定时器到期。

返回值
None.

依赖项
None.

15.8 qurt_timer_attr_set_group()

15.8.1 功能文档

15.8.1.1 void qurt_timer_attr_set_group ( qurt_timer_attr_t ∗ attr, unsigned int group)

在指定的定时器属性结构中设置定时器组标识符。
定时器组标识符指定定时器所属的组。 定时器组用于在单个操作中启用或禁用一个或多个定时器。
定时器组标识符值必须介于 0 和 (QURT_TIMER_MAX_GROUPS-1) 之间（第 15 节）。

相关数据类型
qurt_timer_attr_t

参数

in,out	attr	指向计时器属性对象的指针
in	group	定时器组标识符； 有效范围是 0 到 (QURT_TIMER_MAX_GROUPS - 1)。

返回值
None.

依赖项
None.

15.9 qurt_timer_attr_set_type()

15.9.1 功能文档

15.9.1.1 void qurt_timer_attr_set_type ( qurt_timer_attr_t ∗ attr, qurt_timer_type_t type )

在指定的定时器属性结构中设置定时器类型。
定时器类型指定定时器的功能行为：

• 一次性定时器(QURT_TIMER_ONESHOT) 等待指定的定时器持续时间，然后生成单个定时器事件。 在此之后，计时器不起作用。
• 周期性定时器(QURT_TIMER_PERIODIC) 重复等待指定的定时器持续时间，然后生成定时器事件。 结果是一系列定时器事件，其间隔等于定时器持续时间。

相关数据类型
qurt_timer_attr_t
qurt_timer_type_t

参数

in,out	attr	指向计时器属性结构的指针。
in	type	定时器类型。 值为： QURT_TIMER_ONESHOT – 一次性计时器。 QURT_TIMER_PERIODIC – 周期性定时器。

返回值
None.

依赖项
None.

15.10 qurt_timer_create()

15.10.1 功能文档

15.10.1.1 int qurt_timer_create ( qurt_timer_t ∗ timer, const qurt_timer_attr_t ∗ attr,const qurt_anysignal_t ∗ signal, unsigned int mask )

创建一个计时器。
分配并初始化一个定时器对象，并启动定时器。
注意：必须定义定时器事件处理程序以等待指定的信号来处理定时器事件。

相关数据类型
qurt_timer_t
qurt_timer_attr_t
qurt_anysignal_t

参数

out	timer	指向创建的计时器对象的指针。
in	attr	指向计时器属性结构的指针。
in	signal	指向计时器到期时设置的信号对象的指针。
in	mask	信号掩码，指定时间到期时要在信号对象中设置的信号。

返回值
QURT_EOK – 成功。
QURT_EMEM – 没有足够的内存来创建计时器。

依赖项
None.

15.11 qurt_timer_delete()

15.11.1 功能文档

15.11.1.1 int qurt_timer_delete ( qurt_timer_t timer )

删除计时器。
销毁指定的计时器并释放计时器对象。

相关数据类型
qurt_timer_t

参数

in	timer	计时器对象。

返回值
QURT_EOK – 成功。
QURT_EVAL – 传递的参数不是有效的计时器。

依赖项
None.