From f2818fb9bcc422a15b5c1f3448b28ea78d3b21a7 Mon Sep 17 00:00:00 2001 From: lihui Date: Mon, 30 Jun 2025 12:51:30 +0800 Subject: [PATCH 1/2] fix native fence syscap Signed-off-by: lihui --- .../graphic/graphic_2d/native_fence/native_fence.h | 9 ++------- 1 file changed, 2 insertions(+), 7 deletions(-) diff --git a/zh-cn/native_sdk/graphic/graphic_2d/native_fence/native_fence.h b/zh-cn/native_sdk/graphic/graphic_2d/native_fence/native_fence.h index 15b4d435..9bf04eb0 100755 --- a/zh-cn/native_sdk/graphic/graphic_2d/native_fence/native_fence.h +++ b/zh-cn/native_sdk/graphic/graphic_2d/native_fence/native_fence.h @@ -19,7 +19,6 @@ * * @brief 提供NativeFence功能，通过提供的接口，可以实现对fenceFd阻塞指定时间、永久阻塞、关闭和检查fenceFd是否有效等操作。 * - * @syscap SystemCapability.Graphic.Graphic2D.NativeFence * @since 20 * @version 1.0 */ @@ -32,7 +31,7 @@ * @include native_fence/native_fence.h * @library libnative_fence.so * @kit ArkGraphics2D - * @syscap SystemCapability.Graphic.Graphic2D.NativeFence + * @syscap SystemCapability.Graphic.Graphic2D.NativeWindow * @since 20 * @version 1.0 */ @@ -49,7 +48,6 @@ extern "C" { /** * @brief 检查fenceFd是否有效。 * - * @syscap SystemCapability.Graphic.Graphic2D.NativeFence * @param fenceFd 表示一个文件描述符，用于定时同步。 * @return 返回true表示fenceFd有效，返回false表示该值是一个负整数。 * @since 20 @@ -61,9 +59,8 @@ bool OH_NativeFence_IsValid(int fenceFd); * @brief 阻塞传入的fenceFd。最大阻塞时间由超时参数决定。 * 传入的fenceFd需要用户自己关闭。 * - * @syscap SystemCapability.Graphic.Graphic2D.NativeFence * @param fenceFd 表示一个文件描述符，用于定时同步。 - * @param timeout 表示等待时间。单位为毫秒，-1表示永久等待，0表示接口立即返回。 + * @param timeout 表示等待时间。单位为毫秒，0表示接口立即返回。 * @return 返回true表示对应的fenceFd有信号触发； * 在以下情况会返回false： * 1.传入的fenceFd为负整数。 @@ -80,7 +77,6 @@ bool OH_NativeFence_Wait(int fenceFd, uint32_t timeout); * @brief 永久阻塞传入的fenceFd。 * 传入的fenceFd需要用户自己关闭。 * - * @syscap SystemCapability.Graphic.Graphic2D.NativeFence * @param fenceFd 表示一个文件描述符，用于定时同步。 * @return 返回true表示对应的fenceFd有信号触发； * 在以下情况会返回false： @@ -95,7 +91,6 @@ bool OH_NativeFence_WaitForever(int fenceFd); /** * @brief 关闭fenceFd。 * - * @syscap SystemCapability.Graphic.Graphic2D.NativeFence * @param fenceFd 表示一个文件描述符，用于定时同步。该值是一个非负整数。 * @since 20 * @version 1.0 -- Gitee From 90afd5733485ada57f2445f4093899280a5a6555 Mon Sep 17 00:00:00 2001 From: lihui Date: Thu, 10 Jul 2025 14:58:49 +0800 Subject: [PATCH 2/2] fix DocLinter Signed-off-by: lihui --- .../graphic_2d/native_fence/native_fence.h | 20 +++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/zh-cn/native_sdk/graphic/graphic_2d/native_fence/native_fence.h b/zh-cn/native_sdk/graphic/graphic_2d/native_fence/native_fence.h index 9bf04eb0..c57cd27f 100755 --- a/zh-cn/native_sdk/graphic/graphic_2d/native_fence/native_fence.h +++ b/zh-cn/native_sdk/graphic/graphic_2d/native_fence/native_fence.h @@ -46,10 +46,10 @@ extern "C" { #endif /** - * @brief 检查fenceFd是否有效。 + * @brief 检查 `fenceFd` 是否有效。 * - * @param fenceFd 表示一个文件描述符，用于定时同步。 - * @return 返回true表示fenceFd有效，返回false表示该值是一个负整数。 + * @param fenceFd 表示一个文件描述符，用于同步信号。 + * @return 返回true表示fenceFd有效，返回false表示fenceFd无效，为负整数。 * @since 20 * @version 1.0 */ @@ -57,9 +57,9 @@ bool OH_NativeFence_IsValid(int fenceFd); /** * @brief 阻塞传入的fenceFd。最大阻塞时间由超时参数决定。 - * 传入的fenceFd需要用户自己关闭。 + * 用户需自行关闭fenceFd。 * - * @param fenceFd 表示一个文件描述符，用于定时同步。 + * @param fenceFd 表示一个文件描述符，用于同步信号。 * @param timeout 表示等待时间。单位为毫秒，0表示接口立即返回。 * @return 返回true表示对应的fenceFd有信号触发； * 在以下情况会返回false： @@ -67,7 +67,7 @@ bool OH_NativeFence_IsValid(int fenceFd); * 2.在指定的超时时间内无信号触发。 * 3.调用底层poll接口失败。 * 4.超时时间设置为0。 - * 5.接口中复制文件描述符执行失败。 + * 5.复制文件描述符失败。 * @since 20 * @version 1.0 */ @@ -75,14 +75,14 @@ bool OH_NativeFence_Wait(int fenceFd, uint32_t timeout); /** * @brief 永久阻塞传入的fenceFd。 - * 传入的fenceFd需要用户自己关闭。 + * 用户需自行关闭fenceFd。 * - * @param fenceFd 表示一个文件描述符，用于定时同步。 + * @param fenceFd 表示一个文件描述符，用于同步信号。 * @return 返回true表示对应的fenceFd有信号触发； * 在以下情况会返回false： * 1.传入的fenceFd为负整数。 * 2.在指定的超时时间内无信号触发，永久等待。 - * 3.接口中复制文件描述符执行失败。 + * 3.复制文件描述符失败。 * @since 20 * @version 1.0 */ @@ -91,7 +91,7 @@ bool OH_NativeFence_WaitForever(int fenceFd); /** * @brief 关闭fenceFd。 * - * @param fenceFd 表示一个文件描述符，用于定时同步。该值是一个非负整数。 + * @param fenceFd 表示一个文件描述符，用于同步信号。该值是一个非负整数。 * @since 20 * @version 1.0 */ -- Gitee