openharmony 鸿蒙 capi-timer-h

2026-08-25 浏览 (1)

timer.h

概述

声明定时器的C接口。

引用文件: <ffrt/timer.h>

库: libffrt.z.so

系统能力: SystemCapability.Resourceschedule.Ffrt.Core

起始版本: 12

相关模块: FFRT

汇总

函数

名称描述
FFRT_C_API ffrt_timer_t ffrt_timer_start(ffrt_qos_t qos, uint64_t timeout, void* data, ffrt_timer_cb cb, bool repeat)启动计时器。
FFRT_C_API int ffrt_timer_stop(ffrt_qos_t qos, ffrt_timer_t handle)关闭计时器。

函数说明

ffrt_timer_start()

FFRT_C_API ffrt_timer_t ffrt_timer_start(ffrt_qos_t qos, uint64_t timeout, void* data, ffrt_timer_cb cb, bool repeat)

描述

启动计时器。

不建议在cb中调用exit函数,可能导致未定义行为。

起始版本: 12

参数:

参数项描述
ffrt_qos_t qosQoS等级。
uint64_t timeout超时时间(毫秒)。
void* data超时后回调函数的入参。
ffrt_timer_cb cb超时执行的回调函数。
bool repeat是否重复执行该定时器(该功能暂未支持)。

返回:

类型说明
FFRT_C_API ffrt_timer_t返回定时器句柄。

ffrt_timer_stop()

FFRT_C_API int ffrt_timer_stop(ffrt_qos_t qos, ffrt_timer_t handle)

描述

关闭计时器。

说明:

为阻塞接口,请避免在回调函数callback内使用,防止死锁或同步问题。

当传入的handle对应的callback正在执行时,该函数会等待callback完成后再继续执行。

起始版本: 12

参数:

参数项描述
ffrt_qos_t qosQoS等级。
ffrt_timer_t handle定时器句柄。

返回:

类型说明
FFRT_C_API int关闭成功返回0,
关闭失败返回-1。

你可能感兴趣的鸿蒙文章

openharmony 鸿蒙 capi-fiber-h

openharmony 鸿蒙 capi-ffrt-ffrt-mutex-t

openharmony 鸿蒙 capi-ffrt-ffrt-rwlockattr-t

openharmony 鸿蒙 Readme-CN

openharmony 鸿蒙 capi-loop-h

openharmony 鸿蒙 capi-ffrt-ffrt-rwlock-t

openharmony 鸿蒙 capi-shared-mutex-h

openharmony 鸿蒙 capi-ffrt-ffrt-queue-attr-t

openharmony 鸿蒙 capi-ffrt

openharmony 鸿蒙 capi-ffrt-ffrt-fiber-t

  • 所属分类: 后端技术
  • 本文标签: 软件 鸿蒙
  • 版权声明: 本文链接 https://seaxiang.com/blog/7qyXMKkr