openharmony 鸿蒙 capi-hidebug-type-h

2026-08-25 浏览 (1)

hidebug_type.h

概述

HiDebug模块代码结构体定义。

引用文件： <hidebug/hidebug_type.h>

库： libohhidebug.so

系统能力： SystemCapability.HiviewDFX.HiProfiler.HiDebug

起始版本： 12

相关模块： HiDebug

汇总

结构体

名称typedef关键字描述
HiDebug_ThreadCpuUsageHiDebug_ThreadCpuUsage应用程序所有线程的CPU使用率结构体定义。
HiDebug_SystemMemInfoHiDebug_SystemMemInfo系统内存信息结构类型定义。
HiDebug_NativeMemInfoHiDebug_NativeMemInfo应用程序进程本机内存信息结构类型定义。
HiDebug_MemoryLimitHiDebug_MemoryLimit应用程序进程内存限制结构类型定义。
OH_HiDebug_RequestTraceConfigOH_HiDebug_RequestTraceConfig请求trace采集的配置结构类型定义。
HiDebug_JsStackFrameHiDebug_JsStackFramejs栈帧内容的定义。
HiDebug_NativeStackFrameHiDebug_NativeStackFramenative栈帧内容的定义。
HiDebug_StackFrameHiDebug_StackFrame栈帧内容的定义。
HiDebug_MallocDispatchHiDebug_MallocDispatch应用程序进程可替换/恢复的HiDebug_MallocDispatch表结构类型定义。
HiDebug_GraphicsMemorySummaryHiDebug_GraphicsMemorySummary应用图形显存占用详情的结构定义。
HiDebug_ProcessSamplerConfigHiDebug_ProcessSamplerConfig采样配置的结构定义。
HiDebug_Backtrace_Object__*HiDebug_Backtrace_Object用于栈回溯及栈解析的对象。
HiDebug_ThreadCpuUsage*HiDebug_ThreadCpuUsagePtrHiDebug_ThreadCpuUsage指针定义。
OH_HiDebug_ResProfilerConfigOH_HiDebug_ResProfilerConfig定义资源采集配置结构体类型。
OH_HiDebug_ProfilingResultOH_HiDebug_ProfilingResult封装单次资源采集的结果。

枚举

名称typedef关键字描述
HiDebug_ErrorCodeHiDebug_ErrorCode错误码定义。
HiDebug_TraceFlagHiDebug_TraceFlag采集trace线程的类型。
HiDebug_StackFrameTypeHiDebug_StackFrameType栈帧类型的枚举值定义。
HiDebug_CrashObjTypeHiDebug_CrashObjType维测信息数据类型的枚举。
OH_HiDebug_ResourceTypeOH_HiDebug_ResourceType定义资源采集类型的枚举。

宏定义

名称描述
HIDEBUG_TRACE_TAG_FFRT (1ULL << 13)FFRT任务标签。
起始版本： 12
HIDEBUG_TRACE_TAG_COMMON_LIBRARY (1ULL << 16)公共库子系统标签。
起始版本： 12
HIDEBUG_TRACE_TAG_HDF (1ULL << 18)HDF子系统标签。
起始版本： 12
HIDEBUG_TRACE_TAG_NET (1ULL << 23)网络标签。
起始版本： 12
HIDEBUG_TRACE_TAG_NWEB (1ULL << 24)NWeb标签。
起始版本： 12
HIDEBUG_TRACE_TAG_DISTRIBUTED_AUDIO (1ULL << 27)分布式音频标签。
起始版本： 12
HIDEBUG_TRACE_TAG_FILE_MANAGEMENT (1ULL << 29)文件管理标签。
起始版本： 12
HIDEBUG_TRACE_TAG_OHOS (1ULL << 30)OHOS通用标签。
起始版本： 12
HIDEBUG_TRACE_TAG_ABILITY_MANAGER (1ULL << 31)Ability Manager标签。
起始版本： 12
HIDEBUG_TRACE_TAG_CAMERA (1ULL << 32)相机模块标签。
起始版本： 12
HIDEBUG_TRACE_TAG_MEDIA (1ULL << 33)媒体模块标签。
起始版本： 12
HIDEBUG_TRACE_TAG_IMAGE (1ULL << 34)图像模块标签。
起始版本： 12
HIDEBUG_TRACE_TAG_AUDIO (1ULL << 35)音频模块标签。
起始版本： 12
HIDEBUG_TRACE_TAG_DISTRIBUTED_DATA (1ULL << 36)分布式数据管理器模块标签。
起始版本： 12
HIDEBUG_TRACE_TAG_GRAPHICS (1ULL << 38)图形模块标签。
起始版本： 12
HIDEBUG_TRACE_TAG_ARKUI (1ULL << 39)ArkUI开发框架标签。
起始版本： 12
HIDEBUG_TRACE_TAG_NOTIFICATION (1ULL << 40)通知模块标签。
起始版本： 12
HIDEBUG_TRACE_TAG_MISC (1ULL << 41)MISC模块标签。
起始版本： 12
HIDEBUG_TRACE_TAG_MULTIMODAL_INPUT (1ULL << 42)多模态输入模块标签。
起始版本： 12
HIDEBUG_TRACE_TAG_RPC (1ULL << 46)RPC标签。
起始版本： 12
HIDEBUG_TRACE_TAG_ARK (1ULL << 47)JSVM虚拟机标签。
起始版本： 12
HIDEBUG_TRACE_TAG_WINDOW_MANAGER (1ULL << 48)窗口管理器标签。
起始版本： 12
HIDEBUG_TRACE_TAG_DISTRIBUTED_SCREEN (1ULL << 50)分布式屏幕标签。
起始版本： 12
HIDEBUG_TRACE_TAG_DISTRIBUTED_CAMERA (1ULL << 51)分布式相机标签。
起始版本： 12
HIDEBUG_TRACE_TAG_DISTRIBUTED_HARDWARE_FRAMEWORK (1ULL << 52)分布式硬件框架标签。
起始版本： 12
HIDEBUG_TRACE_TAG_GLOBAL_RESOURCE_MANAGER (1ULL << 53)全局资源管理器标签。
起始版本： 12
HIDEBUG_TRACE_TAG_DISTRIBUTED_HARDWARE_DEVICE_MANAGER (1ULL << 54)分布式硬件设备管理器标签。
起始版本： 12
HIDEBUG_TRACE_TAG_SAMGR (1ULL << 55)SA标签。
起始版本： 12
HIDEBUG_TRACE_TAG_POWER_MANAGER (1ULL << 56)电源管理器标签。
起始版本： 12
HIDEBUG_TRACE_TAG_DISTRIBUTED_SCHEDULER (1ULL << 57)分布式调度程序标签。
起始版本： 12
HIDEBUG_TRACE_TAG_DISTRIBUTED_INPUT (1ULL << 59)分布式输入标签。
起始版本： 12
HIDEBUG_TRACE_TAG_BLUETOOTH (1ULL << 60)蓝牙标签。
起始版本： 12

函数

名称typedef关键字描述
typedef void (*OH_HiDebug_RequestTraceCallback)(HiDebug_ErrorCode errorCode, const char* filePath)OH_HiDebug_RequestTraceCallback请求trace采集的回调类型定义。
typedef void (*OH_HiDebug_ProfilingCallback)(OH_HiDebug_ProfilingResult* result)OH_HiDebug_ProfilingCallback定义资源采集回调函数。

枚举类型说明

HiDebug_ErrorCode

enum HiDebug_ErrorCode

描述

错误码定义。

起始版本： 12

枚举项描述
HIDEBUG_SUCCESS = 0成功。
HIDEBUG_INVALID_ARGUMENT = 401无效参数，可能的原因： 1.参数传值问题；2.参数类型问题。
HIDEBUG_TRACE_CAPTURED_ALREADY = 11400102重复采集。
HIDEBUG_NO_PERMISSION = 11400103没有写文件的权限。
HIDEBUG_TRACE_ABNORMAL = 11400104系统内部错误。
HIDEBUG_NO_TRACE_RUNNING = 11400105当前没有trace正在运行。
OH_HIDEBUG_TRACE_STORAGE_LIMIT = 11400120trace文件存储达到限制。
起始版本： 24。
HIDEBUG_INVALID_SYMBOLIC_PC_ADDRESS = 11400200传入符号解析函数的pc地址是无效的。
起始版本： 20。
HIDEBUG_NOT_SUPPORTED = 11400300当前设备不支持。
起始版本： 22
HIDEBUG_UNDER_SAMPLING = 11400301当前进程正在采样。
起始版本： 22
HIDEBUG_RESOURCE_UNAVAILABLE = 11400302采样资源不可用。
起始版本： 22
HIDEBUG_RES_PROF_SUCCESS = 11400400资源采集启动/停止成功。
起始版本： 24
HIDEBUG_RES_PROF_INVALID_ARG = 11400410资源采集参数无效。
起始版本： 24
HIDEBUG_RES_PROF_INVALID_MAX_DURATION = 11400411资源采集最大持续时间参数无效。
起始版本： 24
HIDEBUG_RES_PROF_INVALID_FILTER_SIZE = 11400412资源采集过滤大小参数无效。
起始版本： 24
HIDEBUG_RES_PROF_INVALID_MAX_STACK_DEPTH = 11400413资源采集最大回栈深度参数无效。
起始版本： 24
HIDEBUG_RES_PROF_INVALID_STATISTICS_INTERVAL = 11400414资源采集统计间隔参数无效。
起始版本： 24
HIDEBUG_RES_PROF_INVALID_SAMPLE_INTERVAL = 11400415资源采集采样大小参数无效。
起始版本： 24
HIDEBUG_RES_PROF_INVALID_RESOURCE_TYPE = 11400416资源采集资源类型参数无效。
起始版本： 24
HIDEBUG_RES_PROF_PERMISSION_DENIED = 11400420资源采集权限不足，采集资源的目标进程仅支持调用接口进程本身。
起始版本： 24
HIDEBUG_RES_PROF_ALREADY_STARTED = 11400421资源采集重复启动。
起始版本： 24
HIDEBUG_RES_PROF_NOT_STARTED = 11400422资源采集未启动，停止失败。
起始版本： 24
HIDEBUG_RES_PROF_PROCESS_OVERLIMIT = 11400423资源采集进程数超出 4 个限制。
起始版本： 24
HIDEBUG_RES_PROF_CONFLICT = 11400424资源采集与命令行工具或系统采集任务冲突。
起始版本： 24
HIDEBUG_RES_PROF_AUTO_STOPPED_BY_DURATION = 11400425资源采集到达指定最大持续时间限制自动停止。
起始版本： 24
HIDEBUG_RES_PROF_DAILY_QUOTA_EXCEEDED = 11400426资源采集每日配额超出 10 次限制。
起始版本： 24
HIDEBUG_RES_PROF_CPU_OVERLOADED = 11400427系统 CPU 处于高负载状态，CPU 占用率超过 70%。
起始版本： 24
HIDEBUG_RES_PROF_MEM_PRESSURE_CRITICAL = 11400428内存可用空间紧张，可用空间少于 15%。
起始版本： 24
HIDEBUG_RES_PROF_STORAGE_PRESSURE_CRITICAL = 11400429存储可用空间紧张，可用空间少于 15%。
起始版本： 24
HIDEBUG_RES_PROF_FAILURE = 11400430资源采集启动/停止失败。
起始版本： 24

HiDebug_TraceFlag

enum HiDebug_TraceFlag

描述

采集trace线程的类型。

起始版本： 12

枚举项描述
HIDEBUG_TRACE_FLAG_MAIN_THREAD = 1只采集当前应用主线程。
HIDEBUG_TRACE_FLAG_ALL_THREADS = 2采集当前应用下所有线程。

HiDebug_StackFrameType

enum HiDebug_StackFrameType

描述

栈帧类型的枚举值定义。

起始版本： 20

枚举项描述
HIDEBUG_STACK_FRAME_TYPE_JS = 1js类型栈帧。
HIDEBUG_STACK_FRAME_TYPE_NATIVE = 2native类型栈帧。

HiDebug_CrashObjType

enum HiDebug_CrashObjType

描述

维测信息数据类型的枚举。

起始版本： 23

枚举项描述
HIDEBUG_CRASHOBJ_STRING = 0字符串
HIDEBUG_CRASHOBJ_MEMORY_64B = 164字节内存块
HIDEBUG_CRASHOBJ_MEMORY_256B = 2256字节内存块
HIDEBUG_CRASHOBJ_MEMORY_1024B = 31024字节内存块
HIDEBUG_CRASHOBJ_MEMORY_2048B = 42048字节内存块
HIDEBUG_CRASHOBJ_MEMORY_4096B = 54096字节内存块

OH_HiDebug_ResourceType

enum OH_HiDebug_ResourceType

描述

定义资源采集类型的枚举。

起始版本： 24

枚举项描述
OH_RES_TYPE_FD文件描述符
起始版本： 24
OH_RES_TYPE_THREAD线程
起始版本： 24
OH_RES_TYPE_NATIVENative 内存
起始版本： 24
OH_RES_TYPE_GPUGPU 内存
起始版本： 24
OH_RES_TYPE_GLOBAL_HANDLE全局句柄
起始版本： 24

宏定义说明

HIDEBUG_TRACE_TAG_FFRT

#define HIDEBUG_TRACE_TAG_FFRT (1ULL << 13)

描述

FFRT任务标签。

起始版本： 12

HIDEBUG_TRACE_TAG_COMMON_LIBRARY

#define HIDEBUG_TRACE_TAG_COMMON_LIBRARY (1ULL << 16)

描述

公共库子系统标签。

起始版本： 12

HIDEBUG_TRACE_TAG_HDF

#define HIDEBUG_TRACE_TAG_HDF (1ULL << 18)

描述

HDF子系统标签。

起始版本： 12

HIDEBUG_TRACE_TAG_NET

#define HIDEBUG_TRACE_TAG_NET (1ULL << 23)

描述

网络标签。

起始版本： 12

HIDEBUG_TRACE_TAG_NWEB

#define HIDEBUG_TRACE_TAG_NWEB (1ULL << 24)

描述

NWeb标签。

起始版本： 12

HIDEBUG_TRACE_TAG_DISTRIBUTED_AUDIO

#define HIDEBUG_TRACE_TAG_DISTRIBUTED_AUDIO (1ULL << 27)

描述

分布式音频标签。

起始版本： 12

HIDEBUG_TRACE_TAG_FILE_MANAGEMENT

#define HIDEBUG_TRACE_TAG_FILE_MANAGEMENT (1ULL << 29)

描述

文件管理标签。

起始版本： 12

HIDEBUG_TRACE_TAG_OHOS

#define HIDEBUG_TRACE_TAG_OHOS (1ULL << 30)

描述

OHOS通用标签。

起始版本： 12

HIDEBUG_TRACE_TAG_ABILITY_MANAGER

#define HIDEBUG_TRACE_TAG_ABILITY_MANAGER (1ULL << 31)

描述

Ability Manager标签。

起始版本： 12

HIDEBUG_TRACE_TAG_CAMERA

#define HIDEBUG_TRACE_TAG_CAMERA (1ULL << 32)

描述

相机模块标签。

起始版本： 12

HIDEBUG_TRACE_TAG_MEDIA

#define HIDEBUG_TRACE_TAG_MEDIA (1ULL << 33)

描述

媒体模块标签。

起始版本： 12

HIDEBUG_TRACE_TAG_IMAGE

#define HIDEBUG_TRACE_TAG_IMAGE (1ULL << 34)

描述

图像模块标签。

起始版本： 12

HIDEBUG_TRACE_TAG_AUDIO

#define HIDEBUG_TRACE_TAG_AUDIO (1ULL << 35)

描述

音频模块标签。

起始版本： 12

HIDEBUG_TRACE_TAG_DISTRIBUTED_DATA

#define HIDEBUG_TRACE_TAG_DISTRIBUTED_DATA (1ULL << 36)

描述

分布式数据管理器模块标签。

起始版本： 12

HIDEBUG_TRACE_TAG_GRAPHICS

#define HIDEBUG_TRACE_TAG_GRAPHICS (1ULL << 38)

描述

图形模块标签。

起始版本： 12

HIDEBUG_TRACE_TAG_ARKUI

#define HIDEBUG_TRACE_TAG_ARKUI (1ULL << 39)

描述

ArkUI开发框架标签。

起始版本： 12

HIDEBUG_TRACE_TAG_NOTIFICATION

#define HIDEBUG_TRACE_TAG_NOTIFICATION (1ULL << 40)

描述

通知模块标签。

起始版本： 12

HIDEBUG_TRACE_TAG_MISC

#define HIDEBUG_TRACE_TAG_MISC (1ULL << 41)

描述

MISC模块标签。

起始版本： 12

HIDEBUG_TRACE_TAG_MULTIMODAL_INPUT

#define HIDEBUG_TRACE_TAG_MULTIMODAL_INPUT (1ULL << 42)

描述

多模态输入模块标签。

起始版本： 12

HIDEBUG_TRACE_TAG_RPC

#define HIDEBUG_TRACE_TAG_RPC (1ULL << 46)

描述

RPC标签。

起始版本： 12

HIDEBUG_TRACE_TAG_ARK

#define HIDEBUG_TRACE_TAG_ARK (1ULL << 47)

描述

JSVM虚拟机标签。

起始版本： 12

HIDEBUG_TRACE_TAG_WINDOW_MANAGER

#define HIDEBUG_TRACE_TAG_WINDOW_MANAGER (1ULL << 48)

描述

窗口管理器标签。

起始版本： 12

HIDEBUG_TRACE_TAG_DISTRIBUTED_SCREEN

#define HIDEBUG_TRACE_TAG_DISTRIBUTED_SCREEN (1ULL << 50)

描述

分布式屏幕标签。

起始版本： 12

HIDEBUG_TRACE_TAG_DISTRIBUTED_CAMERA

#define HIDEBUG_TRACE_TAG_DISTRIBUTED_CAMERA (1ULL << 51)

描述

分布式相机标签。

起始版本： 12

HIDEBUG_TRACE_TAG_DISTRIBUTED_HARDWARE_FRAMEWORK

#define HIDEBUG_TRACE_TAG_DISTRIBUTED_HARDWARE_FRAMEWORK (1ULL << 52)

描述

分布式硬件框架标签。

起始版本： 12

HIDEBUG_TRACE_TAG_GLOBAL_RESOURCE_MANAGER

#define HIDEBUG_TRACE_TAG_GLOBAL_RESOURCE_MANAGER (1ULL << 53)

描述

全局资源管理器标签。

起始版本： 12

HIDEBUG_TRACE_TAG_DISTRIBUTED_HARDWARE_DEVICE_MANAGER

#define HIDEBUG_TRACE_TAG_DISTRIBUTED_HARDWARE_DEVICE_MANAGER (1ULL << 54)

描述

分布式硬件设备管理器标签。

起始版本： 12

HIDEBUG_TRACE_TAG_SAMGR

#define HIDEBUG_TRACE_TAG_SAMGR (1ULL << 55)

描述

SA标签。

起始版本： 12

HIDEBUG_TRACE_TAG_POWER_MANAGER

#define HIDEBUG_TRACE_TAG_POWER_MANAGER (1ULL << 56)

描述

电源管理器标签。

起始版本： 12

HIDEBUG_TRACE_TAG_DISTRIBUTED_SCHEDULER

#define HIDEBUG_TRACE_TAG_DISTRIBUTED_SCHEDULER (1ULL << 57)

描述

分布式调度程序标签。

起始版本： 12

HIDEBUG_TRACE_TAG_DISTRIBUTED_INPUT

#define HIDEBUG_TRACE_TAG_DISTRIBUTED_INPUT (1ULL << 59)

描述

分布式输入标签。

起始版本： 12

HIDEBUG_TRACE_TAG_BLUETOOTH

#define HIDEBUG_TRACE_TAG_BLUETOOTH (1ULL << 60)

描述

蓝牙标签。

起始版本： 12

函数说明

OH_HiDebug_RequestTraceCallback()

typedef void (*OH_HiDebug_RequestTraceCallback)(HiDebug_ErrorCode errorCode, const char* filePath)

描述

请求trace采集的回调类型定义。

起始版本： 24

参数：

参数项描述
HiDebug_ErrorCode errorCode返回结果码，参考HiDebug_ErrorCode。
const char* filePath返回采集的trace文件，失败时可能是空指针。

OH_HiDebug_ProfilingCallback()

typedef void (*OH_HiDebug_ProfilingCallback)(OH_HiDebug_ProfilingResult* result)

描述

定义资源采集回调函数。

起始版本： 24

参数：

参数项描述
OH_HiDebug_ProfilingResult* result资源采集回调函数的参数。

你可能感兴趣的鸿蒙文章

openharmony 鸿蒙 js-apis-hiviewdfx-FaultLogExtensionAbility

openharmony 鸿蒙 capi-log-h

openharmony 鸿蒙 errorcode-hisysevent-sys

openharmony 鸿蒙 capi-hitrace-hitraceid

openharmony 鸿蒙 capi-hidebug-hidebug-threadcpuusage

openharmony 鸿蒙 js-apis-loglibrary-sys

openharmony 鸿蒙 capi-hiappevent-h

openharmony 鸿蒙 capi-hidebug-hidebug-jsstackframe

openharmony 鸿蒙 capi-hitrace

openharmony 鸿蒙 capi-hiappevent-param-h

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