以下仅介绍本模块特有错误码，通用错误码请参考通用错误码说明文档。
以下仅介绍本模块特有错误码，通用错误码请参考通用错误码说明文档。
错误信息
Resource unavailable.
错误描述
无法调用接口。
可能原因
图片被跨线程传递，原对象无法调用接口。
处理步骤
请检查图片并按指示操作重新解码。
错误信息
The operation failed. Possible cause: 1.Image upload exception. 2. Decoding process exception. 3. Insufficient memory.
错误描述
操作失败。
可能原因
处理步骤
请检查图片并按指示操作重新解码。
错误信息
IPC error. Possible cause: 1.IPC communication failed. 2. Image upload exception. 3. Decode process exception. 4. Insufficient memory.
错误描述
PixelMap序列化传输失败。
可能原因
处理步骤
请检查图片并按指示操作重新解码。
错误信息
Shared memory does not exist.
错误描述
共享内存空间错误。
可能原因
处理步骤
请检查内存使用情况或重启。
错误信息
The shared memory data is abnormal.
错误描述
共享内存数据异常。
可能原因
处理步骤
请重新启动。
错误信息
Image decoding abnormal.
错误描述
图片解码错误。
可能原因
处理步骤
请检查图片并按指示操作重新解码。
错误信息
The image data is abnormal.
错误描述
图片输入数据错误。
可能原因
处理步骤
请重新输入正确的图片。
错误信息
Image malloc abnormal. This status code is thrown when an error occurs during the process of copying data.
错误描述
图片分配内存错误。
可能原因
设备内存不足或内存被占用。
处理步骤
清理内存后重试。
错误信息
The image data is not supported.
错误描述
图片类型不支持。
可能原因
当前不支持所传入的图片的类型。
处理步骤
请更换图片类型重试。
错误信息
Image initialization abnormal. This status code is thrown when an error occurs during the process of creating empty PixelMap.
错误描述
图片初始化错误。
可能原因
处理步骤
请重新输入正确的参数或更换图片。
错误信息
Failed to get the data.
错误描述
图片获取数据错误。
可能原因
处理步骤
请输入新的图片或检查图片数据。
错误信息
The image data is too large. This status code is thrown when an error occurs during the process of checking size.
错误描述
图片数据太大。
可能原因
图片太大。
处理步骤
更换较小的图片。
错误信息
Image conversion abnormal.
错误描述
图片转换错误。
可能原因
处理步骤
更换图片或者设置支持的编码参数。
错误信息
Failed to convert the color space.
错误描述
图片颜色转换错误。
可能原因
处理步骤
重试或者更换图片类型。
错误信息
Failed to crop the image.
错误描述
裁剪错误。
可能原因
处理步骤
请检查图片数据或修改正确的裁剪参数。
错误信息
The image source data is incorrect.
错误描述
图片源数据错误。
可能原因
图片数据源缺失或错乱。
处理步骤
检查操作步骤或更换图片。
错误信息
The image source data is incomplete.
错误描述
图片源数据不完整。
可能原因
图片源数据缺失。
处理步骤
检查操作步骤或更换图片。
错误信息
The image format does not match.
错误描述
图片格式不匹配。
可能原因
该图片的格式不匹配。
处理步骤
更换匹配类型的图片。
错误信息
Unknown image format.The image data provided is not in a recognized or supported format, or it may be corrupted.
错误描述
图片未知格式。
可能原因
该图片的格式不支持。
处理步骤
更换图片。
错误信息
Image source not parsed.
错误描述
图片源未解析。
可能原因
图片源数据错误。
处理步骤
检查图片源数据。
错误信息
Invalid image parameter.
错误描述
图片无效参数。
可能原因
输入的参数无效。
处理步骤
重新输入正确的参数。
错误信息
Failed to decode the image.
错误描述
解码失败。
可能原因
处理步骤
检查是否读取到图片或更换图片。
错误信息
Failed to register the plugin.
错误描述
注册插件失败。
可能原因
处理步骤
更换图片或检查传入数据。
错误信息
Failed to create the image plugin.
错误描述
创建插件失败。
可能原因
处理步骤
更换图片或检查传入数据。
错误信息
Failed to encode the image.
错误描述
图片编码失败。
可能原因
处理步骤
更换图片或检查传入数据。
错误信息
Add PixelMap out of range.
错误描述
图片添加像素映射失败。
可能原因
处理步骤
请检查映射步骤或更换图片。
错误信息
Image hardware decoding is not supported.
错误描述
不支持图片硬解码。
可能原因
使用了图片硬解码。
处理步骤
使用其他方式解码。
错误信息
Failed to decode the image header.
错误描述
解码图片头异常。
可能原因
处理步骤
更换图片或检查图片数据。
错误信息
The image does not support EXIF decoding.
错误描述
图片不支持exif解码。
可能原因
图片不支持exif解码。
处理步骤
更换图片。
错误信息
The image property does not exist.
错误描述
图片属性不存在。
可能原因
处理步骤
更换图片。
错误信息
The EXIF data is out of range.
错误描述
图片属性赋值超出范围。
可能原因
图片属性赋值超出范围。
处理步骤
更换图片或检查所设置图片属性值的长度。
错误信息
The EXIF value is invalid.
错误描述
图片属性值无效。
可能原因
图片属性缺失。
处理步骤
更换图片或检查图片数据。
错误信息
Invalid media operation.
错误描述
图片操作无效。
可能原因
当前图片格式不支持该操作。
处理步骤
更换图片。
错误信息
The EXIF data failed to be written to the file.
错误描述
图片属性值写入文件失败。
可能原因
图片属性值有异常。
处理步骤
更换图片。
错误信息
Invalid MIME type for the image source.
错误描述
图片参数无效。
可能原因
当前图片格式不支持该操作。
处理步骤
更换图片。
错误信息
Failed to encode icc.
错误描述
编码ICC失败。
可能原因
图片ICC信息存在问题。
处理步骤
检查图片数据或更换图片。
错误信息
The DMA memory does not exist.
错误描述
DMA内存空间错误。
可能原因
处理步骤
请检查内存使用情况或重启。
错误信息
The DMA memory data is abnormal.
错误描述
DMA内存数据异常。
可能原因
处理步骤
重新启动。
错误信息
Abnormal API environment.
错误描述
API环境异常。
可能原因
API使用环境存在问题。
处理步骤
检查SDK版本。
错误信息
Failed to create the PixelMap.
错误描述
PixelMap创建失败。
可能原因
处理步骤
检查函数入参或检查是否提前释放实例。
错误信息
Abnormal buffer size.
错误描述
缓冲区大小异常。
可能原因
参数错误（如区域大小超出、入参值非法等）导致的创建失败。
处理步骤
检查函数入参。
错误信息
FD mapping failed.
错误描述
文件描述符映射失败。
可能原因
传入的文件描述符存在问题。
处理步骤
检查是否传入了正确的文件描述符。
错误信息
Failed to read the pixel map.
错误描述
读取PixelMap失败。
可能原因
处理步骤
重新建立PixelMap或更改可读权限。
错误信息
Failed to write the pixel map.
错误描述
写入像素映射失败。
可能原因
处理步骤
重新建立PixelMap或更改可读权限。
错误信息
PixelMap does not allow modification.
错误描述
PixelMap不允许修改。
可能原因
对PixelMap进行了修改。
处理步骤
停止对PixelMap的修改。
错误信息
Failed to create surface.
错误描述
创建surface失败。
可能原因
图片编码申请内存出错。
处理步骤
重试或者更换图片。
错误信息
Configuration error.
错误描述
配置错误。
可能原因
配置出现错误。
处理步骤
重新进行正确配置。
错误信息
The conversion failed.
错误描述
图片转换失败。
可能原因
处理步骤
更换图片或者设置支持的编码参数。
错误信息
The type to be converted is an unsupported target pixel format.
错误描述
不支持图片转换目标类型。
可能原因
不支持该目标类型的转换。
处理步骤
更换图片或更换转换类型。
错误信息
Memory format not supported.
错误描述
PixelMap设置内存标识符失败。
可能原因
处理步骤
检查是否已释放PixelMap实例。检查内存类型是否匹配。
错误信息
Memory copy failed.
错误描述
内存拷贝失败。
可能原因
处理步骤
检查是否已释放要拷贝的实例。检查内存类型是否匹配。
错误信息
Unsupported mime type.
错误描述
不支持的MIME类型。
可能原因
设备不支持该MIME类型。
处理步骤
检查图片数据或更换图片，可使用相关接口查询编解码能力范围。
错误信息
Unknown mime type.
错误描述
未知的MIME类型。
可能原因
设备不支持该图像类型或图片损坏。
处理步骤
检查图片数据或更换图片。
错误信息
Too large data or image.
错误描述
数据或图片太大。
可能原因
图片尺寸太大。
处理步骤
更换较小的图片。
错误信息
Failed to get the data from Surface.
错误描述
获取图像数据失败。
可能原因
处理步骤
检查图像数据来源或使用新的图像数据。
错误信息
PixelMap has been released.
错误描述
PixelMap已被释放。
可能原因
PixelMap对象已被释放，其关联的native对象已不存在。
处理步骤
检查该PixelMap对象是否存在被提前释放的风险（例如，在异步任务或另一个线程中意外释放），需确保该对象在使用结束前及所有异步方法执行完成前不被释放。
错误信息
PixelMap has been passed to another thread.
错误描述
PixelMap已被传递至另一个线程。
可能原因
PixelMap对象已被传递至另一个线程，原线程的对象无法继续调用接口。
处理步骤
不要在PixelMap对象被传递到另一个线程后仍在原线程调用该对象的接口。
错误信息
DMA memory does not exist.
错误描述
DMA内存不存在。
可能原因
当前操作要求PixelMap使用DMA内存，但传入的PixelMap未使用DMA内存。例如，对共享内存的PixelMap读写HDR元数据，或获取其底层NativeBuffer。
处理步骤
重新创建使用DMA内存的PixelMap，并使用新对象调用原接口。根据输入数据选择创建方式：
关于DMA内存的更多说明，请参见图片解码内存优化(ArkTS)和图片解码内存优化(C/C++)。
错误信息
DMA operation failed.
错误描述
DMA内存操作失败。
可能原因
读写DMA内存时没有正确地进行同步操作。
处理步骤
使用正确的方式读写DMA内存。
错误信息
Unsupported operation, e.g. on cross-platform.
错误描述
不支持的操作。如：修改一个Editable属性为false的PixelMap等。
可能原因
不支持的操作。如：修改一个Editable属性为false的PixelMap等。
处理步骤
使用支持的操作。
错误信息
Unsupported metadata. Possible causes: Unsupported metadata type.
错误描述
不支持的元数据读写。
可能原因
不支持的元数据读写，如不支持的Exif字段，对类型不符的辅助图，获取特定辅助图元数据，如对深度图获取GainmapMetadata。
处理步骤
重新确定辅助图类型和元数据类型是否对应，再进行读写操作。
错误信息
Unsupported conversion.
错误描述
不支持的转换。
可能原因
PixelMap的格式不支持转换。
处理步骤
检查并更换格式匹配的PixelMap数据。
错误信息
Invalid region.
错误描述
无效的区域。
可能原因
Region中设置的顶点位置、宽度或高度超出图片尺寸范围。
处理步骤
检查Region中设置的顶点位置、宽度或高度，确保在图片尺寸范围之内。
错误信息
Unsupported memory format or pixel format.
错误描述
不支持的内存格式或像素格式。
可能原因
接口不支持当前PixelMap的内存格式或像素格式。
处理步骤
查看接口的规格限制，并检查PixelMap的内存格式或像素格式，使用格式支持的PixelMap调用接口。
错误信息
Invalid parameter.
错误描述
非法参数。
可能原因
输入的参数无效。
处理步骤
检查并重新输入正确的参数。
错误信息
Unsupported data format.
错误描述
不支持的数据格式。
可能原因
处理步骤
查看接口文档并使用接口支持的数据格式。
错误信息
HDR image decomposition failed. Possible causes: 1. Decomposition processing is not supported. 2. Processing error occurs.
错误描述
HDR图片分解失败。
可能原因
处理步骤
检查HDR PixelMap的像素格式是否支持分解，或更换图片后重试。
错误信息
Memory alloc failed.
错误描述
申请内存失败。
可能原因
设备内存不足或内存被占用。
处理步骤
清理内存后重试。
错误信息
Memory copy failed.
错误描述
内存拷贝失败。
可能原因
拷贝的内存不存在，设备内存不足。
处理步骤
检查要拷贝的内存是否存在，清理内存后重试。
错误信息
Memory lock or unlock failed.
错误描述
内存锁定或解锁失败。
可能原因
PixelMap或内存地址无效。
处理步骤
检查PixelMap或内存地址是否有效。
错误信息
Failed to create the PixelMap.
错误描述
创建PixelMap失败。
可能原因
处理步骤
检查函数入参或检查是否提前释放了实例。
错误信息
Data conversion failed.
错误描述
数据转换失败。
可能原因
处理步骤
错误信息
Unsupported allocator mode, e.g., use share memory to create a HDR image as only DMA supported hdr metadata.
错误描述
不支持的分配器模式。
可能原因
没有指定内存分配类型，或指定了错误的内存分配类型。例如：使用共享内存方式解码HDR图片就会出错，因为只有DMA方式才支持HDR元数据。
处理步骤
使用正确的内存分配类型。
错误信息
Unknown error.
错误描述
未知错误。
可能原因
未知原因引起的错误。
处理步骤
通过日志查找原因。
错误信息
Bad source.
错误描述
图片源存在问题。
可能原因
处理步骤
检查图片数据或更换图片。
错误信息
Unsupported MIME type.
错误描述
不支持的MIME类型。
可能原因
设备不支持该图片类型。
处理步骤
检查图片数据或更换图片。
错误信息
Image too large.
错误描述
图片太大。
可能原因
图片大小超出限制。
处理步骤
检查图片数据或更换图片。
错误信息
Unsupported allocator type, e.g., use share memory to decode a HDR image as only DMA supported hdr metadata.
错误描述
不支持的内存分配类型。
可能原因
没有指定内存分配类型，或指定了错误的内存分配类型。例如：使用共享内存方式解码HDR图片就会出错，因为只有DMA方式才支持HDR元数据。
处理步骤
使用正确的内存分配类型。
错误信息
Unsupported metadata.
错误描述
不支持的元数据。
可能原因
处理步骤
检查元数据字段是否支持或检查元数据值是否合法。
错误信息
Unsupported options, e.g., cannot convert image into desired pixel format.
错误描述
不支持的选项。
可能原因
部分选项参数配置存在错误，不支持该选项要求的操作。
处理步骤
检查选项参数配置。
错误信息
Invalid parameter.
错误描述
非法参数。
可能原因
输入的参数无效。
处理步骤
检查并重新输入正确的参数。
错误信息
Decode failed.
错误描述
解码失败。
可能原因
处理步骤
检查图片数据或更换图片。
错误信息
Memory allocation failed.
错误描述
内存分配失败。
可能原因
处理步骤
检查设备内存或检查传入数据。
错误信息
Image does not carry thumbnail data.
错误描述
图片不包含缩略图数据。
可能原因
图片文件中不包含缩略图数据，且未开启缩略图生成功能。
处理步骤
检查图片文件是否包含缩略图数据，或开启缩略图生成功能后重试。
错误信息
Thumbnail generation failed.
错误描述
缩略图生成失败。
可能原因
处理步骤
检查输入图片数据和缩略图生成参数，必要时释放系统资源后重试。
错误信息
Failed to write image properties to the file.
错误描述
图片信息写入文件失败。
可能原因
处理步骤
检查图片数据或检查图片文件权限。
错误信息
Unsupported options.
错误描述
不支持的选项。
可能原因
部分选项参数配置存在错误，不支持该选项要求的操作。
处理步骤
检查选项参数配置。
错误信息
Invalid parameter for ImagePacker.
错误描述
编码参数无效。
可能原因
编码参数为空或无效。
处理步骤
检查编码选项参数配置。
错误信息
Encode failed.
错误描述
编码失败。
可能原因
处理步骤
更换图片或检查传入数据。
错误信息
Invalid parameter.
错误描述
非法参数。
可能原因
处理步骤
检查参数配置。