harmony 鸿蒙task.h

2025-06-12
浏览 (9)

task.h

概述

声明任务的C接口。

引用文件：<ffrt/task.h>

库： libffrt.z.so

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

起始版本： 10

相关模块：FFRT

汇总

函数

名称	描述
FFRT_C_API int ffrt_task_attr_init (ffrt_task_attr_t *attr)	初始化任务属性。
FFRT_C_API void ffrt_task_attr_set_name (ffrt_task_attr_t attr, const char name)	设置任务名字。
FFRT_C_API const char * ffrt_task_attr_get_name (const ffrt_task_attr_t *attr)	获取任务名字。
FFRT_C_API void ffrt_task_attr_destroy (ffrt_task_attr_t *attr)	销毁任务属性。
FFRT_C_API void ffrt_task_attr_set_qos (ffrt_task_attr_t *attr, ffrt_qos_t qos)	设置任务QoS。
FFRT_C_API ffrt_qos_t ffrt_task_attr_get_qos (const ffrt_task_attr_t *attr)	获取任务QoS。
FFRT_C_API void ffrt_task_attr_set_delay (ffrt_task_attr_t *attr, uint64_t delay_us)	设置任务延迟时间。
FFRT_C_API uint64_t ffrt_task_attr_get_delay (const ffrt_task_attr_t *attr)	获取任务延迟时间。
FFRT_C_API void ffrt_task_attr_set_queue_priority (ffrt_task_attr_t *attr, ffrt_queue_priority_t priority)	设置并行队列任务优先级。
FFRT_C_API ffrt_queue_priority_t ffrt_task_attr_get_queue_priority (const ffrt_task_attr_t *attr)	获取并行队列任务优先级。
FFRT_C_API void ffrt_task_attr_set_stack_size (ffrt_task_attr_t *attr, uint64_t size)	设置任务栈大小。
FFRT_C_API uint64_t ffrt_task_attr_get_stack_size (const ffrt_task_attr_t *attr)	获取任务栈大小。
FFRT_C_API int ffrt_this_task_update_qos (ffrt_qos_t qos)	更新任务QoS。
FFRT_C_API ffrt_qos_t ffrt_this_task_get_qos (void)	获取任务QoS。
FFRT_C_API uint64_t ffrt_this_task_get_id (void)	获取任务id。
FFRT_C_API void * ffrt_alloc_auto_managed_function_storage_base (ffrt_function_kind_t kind)	申请函数执行结构的内存。
FFRT_C_API void ffrt_submit_base (ffrt_function_header_t f, const ffrt_deps_t in_deps, const ffrt_deps_t out_deps, const ffrt_task_attr_t attr)	提交任务调度执行。
FFRT_C_API ffrt_task_handle_t ffrt_submit_h_base (ffrt_function_header_t f, const ffrt_deps_t in_deps, const ffrt_deps_t out_deps, const ffrt_task_attr_t attr)	提交任务调度执行并返回任务句柄。
FFRT_C_API uint32_t ffrt_task_handle_inc_ref (ffrt_task_handle_t handle)	增加任务句柄的引用数。
FFRT_C_API uint32_t ffrt_task_handle_dec_ref (ffrt_task_handle_t handle)	减少任务句柄的引用计数。
FFRT_C_API void ffrt_task_handle_destroy (ffrt_task_handle_t handle)	销毁任务句柄。
FFRT_C_API void ffrt_wait_deps (const ffrt_deps_t *deps)	等待依赖的任务完成，当前任务开始执行。
FFRT_C_API void ffrt_wait (void)	等待之前所有提交任务完成，当前任务开始执行。