Skip to main content

hi_tde_cancel_job

hi_tde_close​

函数功能​

关闭TDE设备。

约束说明​

函数原型​

hi_s32 hi_tde_close(hi_void)

参数说明​

无

返回值说明​

父主题： TDE图形绘制功能

hi_tde_begin_job​

函数功能​

创建TDE任务，获取任务句柄。TDE以任务形式管理TDE命令，一个TDE任务对应一个job，是一个或多个TDE命令的集合；一个TDE任务内的命令是按顺序执行的，如下图所示。成功创建TDE任务、添加TDE命令后，通过hi_tde_end_job提交任务。

约束说明​

  • 调用hi_tde_open接口打开TDE设备后才可调用本接口。

  • TDE能够同时执行的任务数、命令数最大均不超过200。

  • hi_tde_begin_job需要和hi_tde_end_job配对使用。

  • 该接口不支持多进程。

函数原型​

hi_s32 hi_tde_begin_job(hi_void)

参数说明​

无

返回值说明​

父主题： TDE图形绘制功能

hi_tde_end_job​

函数功能​

提交已创建的TDE任务。

约束说明​

  • 在调用此接口前应保证调用hi_tde_open打开TDE设备，并且调用hi_tde_begin_job获得了有效的任务句柄。
  • 提交任务后，此任务对应的handle会变为无效，再次提交会出现错误码HI_ERR_TDE_INVALID_HANDLE。
  • 该接口不支持多进程。

函数原型​

hi_s32 hi_tde_end_job(hi_s32 handle, hi_bool is_sync, hi_bool is_block, hi_u32 time_out);

参数说明​

参数名输入/输出说明
handle输入tde任务句柄。
is_sync输入同步标志，预留参数，当前固定设置为HI_FALSE。
is_block输入阻塞标志。
- HI_TRUE：阻塞，提交的TDE任务完成或等待指定超时时间后返回。
- HI_FALSE：非阻塞，直接返回，但需要配合hi_tde_wait_for_done或hi_tde_wait_all_done接口使用。
time_out输入超时时间，单位:ms。 当is_block参数设置为阻塞时，可通过本参数设置超时时间；当is_block参数设置为非阻塞时，设置本参数无效。

返回值说明​

父主题： TDE图形绘制功能

hi_tde_cancel_job​

函数功能​

在调用hi_tde_begin_job创建任务之后、调用hi_tde_end_job提交任务之前，可调用本接口取消对应的TDE任务及任务中的命令。

约束说明​

  • 在调用此接口前应保证调用hi_tde_open打开TDE设备，并且调用hi_tde_begin_job获得了有效的任务句柄。

  • 调用hi_tde_end_job接口提交的任务，无法调用本接口取消。

  • 取消后的任务不再有效，不能再向该任务添加命令操作，也不能提交该任务。

  • 该接口不支持多进程。

函数原型​

hi_s32 hi_tde_cancel_job(hi_s32 handle);

参数说明​

参数名输入/输出说明
handle输入tde任务句柄。

返回值说明​

父主题： TDE图形绘制功能

hi_tde_wait_for_done​

函数功能​

调用hi_tde_end_job接口、且使用非阻塞方式提交TDE任务后，调用本接口等待指定TDE任务完成。本接口为阻塞接口，会阻塞到指定TDE任务完成后退出本接口。

约束说明​

  • 在调用此接口前应保证调用hi_tde_open打开TDE设备，并且调用hi_tde_begin_job获得了有效的任务句柄。

  • 该接口不支持多进程。

函数原型​

hi_s32 hi_tde_wait_for_done(hi_s32 handle);

参数说明​

参数名输入/输出说明
handle输入tde任务句柄。

返回值说明​

父主题： TDE图形绘制功能

hi_tde_wait_all_done​

函数功能​

调用hi_tde_end_job接口、且使用非阻塞方式提交TDE任务后，等待当前TDE设备上所有任务完成。本接口为阻塞接口，会阻塞到所有TDE任务完成后退出本接口。

约束说明​

  • 在调用此接口前应保证调用hi_tde_open打开TDE设备，并且调用hi_tde_begin_job获得了有效的任务句柄。

  • 该接口不支持多进程。

函数原型​

hi_s32 hi_tde_wait_all_done(hi_void)

参数说明​

无

返回值说明​

父主题： TDE图形绘制功能

hi_tde_quick_copy​

函数功能​

向指定TDE任务中添加快速拷贝命令，实现将源位图的操作区域拷贝到目标位图的操作区域。

约束说明​

  • 在调用此接口前应保证调用hi_tde_open打开TDE设备，并且调用hi_tde_begin_job获得了有效的任务句柄。

  • 区域大小长度及宽度支持的区间为[1,4096]。

  • 如果目标位图包含目标位图的操作区域，则无需其他操作。如果操作区域与目标位图相交，则裁剪操作区域，有效的操作区域为灰色相交部分。若指定的操作区域与位图不相交，位图及位图操作区域的关系如下图所示。

  • 快速拷贝不支持格式转换，源位图和目标位图格式必须一致，当前仅支持ARGB8888格式。

  • 快速拷贝不支持缩放功能，如果源和目的的操作区域尺寸不一致，则按照两者最小公共区域进行拷贝搬移。

  • 指定操作区域要和指定的位图有公共区域，否则会返回错误。

  • 该接口不支持多进程。

函数原型​

hi_s32 hi_tde_quick_copy(hi_s32 handle, const hi_tde_single_src*single_src)

参数说明​

参数名输入/输出说明
handle输入tde任务句柄。
single_src输入单源位图区域信息和目标位图区域信息结构体。

返回值说明​

父主题： TDE图形绘制功能

在线提单