# Image错误码

> phone | 2in1 | tablet | tv | wearable

> 说明
>
> 以下仅介绍本模块特有错误码，通用错误码请参考[通用错误码说明文档](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)。

## 501 无法调用接口

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Resource unavailable.

**错误描述**

无法调用接口。

**可能原因**

图片被跨线程传递，原对象无法调用接口。

**处理步骤**

请检查图片并按指示操作重新解码。

## 62980096 操作失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

The operation failed. Possible cause: 1.Image upload exception. 2. Decoding process exception. 3. Insufficient memory.

**错误描述**

操作失败。

**可能原因**

1. 上传图片过程中出现异常。
2. 解码过程中有其他操作。
3. 没有按指示操作进行图片解码。
4. 设备的内存不足。
5. 解码库处理失败。

**处理步骤**

请检查图片并按指示操作重新解码。

## 62980097 PixelMap序列化传输失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

IPC error. Possible cause: 1.IPC communication failed. 2. Image upload exception. 3. Decode process exception. 4. Insufficient memory.

**错误描述**

PixelMap序列化传输失败。

**可能原因**

1. 上传图片过程中出现异常。
2. 解码过程中有其他操作。
3. 没有按指示操作进行图片解码。
4. 设备的内存不足。

**处理步骤**

请检查图片并按指示操作重新解码。

## 62980098 共享内存空间错误

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Shared memory does not exist.

**错误描述**

共享内存空间错误。

**可能原因**

1. 内存大小不够。
2. 越界访问共享内存。
3. 使用了无效的指针。

**处理步骤**

请检查内存使用情况或重启。

## 62980099 共享内存数据异常

> phone | 2in1 | tablet | tv | wearable

**错误信息**

The shared memory data is abnormal.

**错误描述**

共享内存数据异常。

**可能原因**

1. 读写共享内存时没有正确地进行同步操作。
2. 越界访问共享内存。
3. 使用了无效的指针。

**处理步骤**

请重新启动。

## 62980100 图片解码错误

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Image decoding abnormal.

**错误描述**

图片解码错误。

**可能原因**

1. 上传图片过程中出现异常。
2. 解码过程中有其他操作。
3. 没有按指示操作进行图片解码。
4. 设备的内存不足。

**处理步骤**

请检查图片并按指示操作重新解码。

## 62980101 图片输入数据错误

> phone | 2in1 | tablet | tv | wearable

**错误信息**

The image data is abnormal.

**错误描述**

图片输入数据错误。

**可能原因**

1. 输入图片数据不对。
2. 输入的图片格式不对。
3. 输入的图片大小不对。

**处理步骤**

请重新输入正确的图片。

## 62980102 图片分配内存错误

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Image malloc abnormal. This status code is thrown when an error occurs during the process of copying data.

**错误描述**

图片分配内存错误。

**可能原因**

设备内存不足或内存被占用。

**处理步骤**

清理内存后重试。

## 62980103 图片类型不支持

> phone | 2in1 | tablet | tv | wearable

**错误信息**

The image data is not supported.

**错误描述**

图片类型不支持。

**可能原因**

当前不支持所传入的图片的类型。

**处理步骤**

请更换图片类型重试。

## 62980104 图片初始化错误

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Image initialization abnormal. This status code is thrown when an error occurs during the process of creating empty PixelMap.

**错误描述**

图片初始化错误。

**可能原因**

1. 图片类型不支持。
2. 图片大小不支持。
3. 初始化过程中出现错误。

**处理步骤**

请重新输入正确的参数或更换图片。

## 62980105 图片获取数据错误

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Failed to get the data.

**错误描述**

图片获取数据错误。

**可能原因**

1. 设备不支持该图片类型。
2. 图片数据丢失。

**处理步骤**

请输入新的图片或检查图片数据。

## 62980106 图片数据太大

> phone | 2in1 | tablet | tv | wearable

**错误信息**

The image data is too large. This status code is thrown when an error occurs during the process of checking size.

**错误描述**

图片数据太大。

**可能原因**

图片太大。

**处理步骤**

更换较小的图片。

## 62980107 图片转换错误

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Image conversion abnormal.

**错误描述**

图片转换错误。

**可能原因**

1. 图片转换过程中异常停止。
2. 编码参数设置错误。

**处理步骤**

更换图片或者设置支持的编码参数。

## 62980108 图片颜色转换错误

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Failed to convert the color space.

**错误描述**

图片颜色转换错误。

**可能原因**

1. 不支持该图片类型的颜色转换。
2. 设备出现问题。

**处理步骤**

重试或者更换图片类型。

## 62980109 裁剪错误

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Failed to crop the image.

**错误描述**

裁剪错误。

**可能原因**

1. 裁剪参数设置错误。
2. 图片数据错误。

**处理步骤**

请检查图片数据或修改正确的裁剪参数。

## 62980110 图片源数据错误

> phone | 2in1 | tablet | tv | wearable

**错误信息**

The image source data is incorrect.

**错误描述**

图片源数据错误。

**可能原因**

图片数据源缺失或错乱。

**处理步骤**

检查操作步骤或更换图片。

## 62980111 图片源数据不完整

> phone | 2in1 | tablet | tv | wearable

**错误信息**

The image source data is incomplete.

**错误描述**

图片源数据不完整。

**可能原因**

图片源数据缺失。

**处理步骤**

检查操作步骤或更换图片。

## 62980112 图片格式不匹配

> phone | 2in1 | tablet | tv | wearable

**错误信息**

The image format does not match.

**错误描述**

图片格式不匹配。

**可能原因**

该图片的格式不匹配。

**处理步骤**

更换匹配类型的图片。

## 62980113 图片未知格式

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Unknown image format.The image data provided is not in a recognized or supported format, or it may be corrupted.

**错误描述**

图片未知格式。

**可能原因**

该图片的格式不支持。

**处理步骤**

更换图片。

## 62980114 图片源未解析

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Image source not parsed.

**错误描述**

图片源未解析。

**可能原因**

图片源数据错误。

**处理步骤**

检查图片源数据。

## 62980115 图片无效参数

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Invalid image parameter.

**错误描述**

图片无效参数。

**可能原因**

输入的参数无效。

**处理步骤**

重新输入正确的参数。

## 62980116 解码失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Failed to decode the image.

**错误描述**

解码失败。

**可能原因**

1. 解码过程中异常退出。
2. 图片格式不支持。
3. 未读取到图片。

**处理步骤**

检查是否读取到图片或更换图片。

## 62980117 注册插件失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Failed to register the plugin.

**错误描述**

注册插件失败。

**可能原因**

1. 未匹配到对应格式的解码或编码插件。
2. 传入数据不正确。

**处理步骤**

更换图片或检查传入数据。

## 62980118 创建插件失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Failed to create the image plugin.

**错误描述**

创建插件失败。

**可能原因**

1. 未匹配到对应格式的解码或编码插件。
2. 传入数据不正确。

**处理步骤**

更换图片或检查传入数据。

## 62980119 图片编码失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Failed to encode the image.

**错误描述**

图片编码失败。

**可能原因**

1. 设置的编码格式不支持。
2. 传入数据不正确。

**处理步骤**

更换图片或检查传入数据。

## 62980120 图片添加像素映射失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Add PixelMap out of range.

**错误描述**

图片添加像素映射失败。

**可能原因**

1. 可能不支持添加像素映射。
2. 添加像素映射过程中异常中断。

**处理步骤**

请检查映射步骤或更换图片。

## 62980121 不支持图片硬解码

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Image hardware decoding is not supported.

**错误描述**

不支持图片硬解码。

**可能原因**

使用了图片硬解码。

**处理步骤**

使用其他方式解码。

## 62980122 解码图片头异常

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Failed to decode the image header.

**错误描述**

解码图片头异常。

**可能原因**

1. 解码头过程中出现异常退出。
2. 图片解码头不符合要求。

**处理步骤**

更换图片或检查图片数据。

## 62980123 图片不支持exif解码

> phone | 2in1 | tablet | tv | wearable

**错误信息**

The image does not support EXIF decoding.

**错误描述**

图片不支持exif解码。

**可能原因**

图片不支持exif解码。

**处理步骤**

更换图片。

## 62980124 图片属性不存在

> phone | 2in1 | tablet | tv | wearable

**错误信息**

The image property does not exist.

**错误描述**

图片属性不存在。

**可能原因**

1. 图片属性缺失。
2. 对图片进行了不合理的修改。

**处理步骤**

更换图片。

## 62980133 图片属性赋值超出范围

> phone | 2in1 | tablet | tv | wearable

**错误信息**

The EXIF data is out of range.

**错误描述**

图片属性赋值超出范围。

**可能原因**

图片属性赋值超出范围。

**处理步骤**

更换图片或检查所设置图片属性值的长度。

## 62980135 图片属性值无效

> phone | 2in1 | tablet | tv | wearable

**错误信息**

The EXIF value is invalid.

**错误描述**

图片属性值无效。

**可能原因**

图片属性缺失。

**处理步骤**

更换图片或检查图片数据。

## 62980137 图片操作无效

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Invalid media operation.

**错误描述**

图片操作无效。

**可能原因**

当前图片格式不支持该操作。

**处理步骤**

更换图片。

## 62980146 图片属性值写入文件失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

The EXIF data failed to be written to the file.

**错误描述**

图片属性值写入文件失败。

**可能原因**

图片属性值有异常。

**处理步骤**

更换图片。

## 62980149 图片参数无效

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Invalid MIME type for the image source.

**错误描述**

图片参数无效。

**可能原因**

当前图片格式不支持该操作。

**处理步骤**

更换图片。

## 62980172 编码ICC失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Failed to encode icc.

**错误描述**

编码ICC失败。

**可能原因**

图片ICC信息存在问题。

**处理步骤**

检查图片数据或更换图片。

## 62980173 DMA内存空间错误

> phone | 2in1 | tablet | tv | wearable

**错误信息**

The DMA memory does not exist.

**错误描述**

DMA内存空间错误。

**可能原因**

1. 内存大小不够。
2. 越界访问内存。
3. 使用了无效的指针。

**处理步骤**

请检查内存使用情况或重启。

## 62980174 DMA内存数据异常

> phone | 2in1 | tablet | tv | wearable

**错误信息**

The DMA memory data is abnormal.

**错误描述**

DMA内存数据异常。

**可能原因**

1. 读写共享内存时没有正确地进行同步操作。
2. 越界访问内存。
3. 使用了无效的指针。

**处理步骤**

重新启动。

## 62980177 API环境异常

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Abnormal API environment.

**错误描述**

API环境异常。

**可能原因**

API使用环境存在问题。

**处理步骤**

检查SDK版本。

## 62980178 PixelMap创建失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Failed to create the PixelMap.

**错误描述**

PixelMap创建失败。

**可能原因**

1. 参数错误（如区域大小超出、入参值非法等）导致的创建失败。
2. 错误地提前释放，导致实例创建失败。

**处理步骤**

检查函数入参或检查是否提前释放实例。

## 62980179 缓冲区大小异常

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Abnormal buffer size.

**错误描述**

缓冲区大小异常。

**可能原因**

参数错误（如区域大小超出、入参值非法等）导致的创建失败。

**处理步骤**

检查函数入参。

## 62980180 文件描述符映射失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

FD mapping failed.

**错误描述**

文件描述符映射失败。

**可能原因**

传入的文件描述符存在问题。

**处理步骤**

检查是否传入了正确的文件描述符。

## 62980246 读取PixelMap失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Failed to read the pixel map.

**错误描述**

读取PixelMap失败。

**可能原因**

1. PixelMap数据错误。
2. 没有读取PixelMap的权限。

**处理步骤**

重新建立PixelMap或更改可读权限。

## 62980247 写入像素映射失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Failed to write the pixel map.

**错误描述**

写入像素映射失败。

**可能原因**

1. PixelMap数据错误。
2. 没有写入PixelMap的权限。

**处理步骤**

重新建立PixelMap或更改可读权限。

## 62980248 PixelMap不允许修改

> phone | 2in1 | tablet | tv | wearable

**错误信息**

PixelMap does not allow modification.

**错误描述**

PixelMap不允许修改。

**可能原因**

对PixelMap进行了修改。

**处理步骤**

停止对PixelMap的修改。

## 62980252 创建surface失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Failed to create surface.

**错误描述**

创建surface失败。

**可能原因**

图片编码申请内存出错。

**处理步骤**

重试或者更换图片。

## 62980259 配置错误

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Configuration error.

**错误描述**

配置错误。

**可能原因**

配置出现错误。

**处理步骤**

重新进行正确配置。

## 62980274 图片转换失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

The conversion failed.

**错误描述**

图片转换失败。

**可能原因**

1. 图片转换过程中异常停止。
2. 编码参数设置错误。

**处理步骤**

更换图片或者设置支持的编码参数。

## 62980276 不支持图片转换目标类型

> phone | 2in1 | tablet | tv | wearable

**错误信息**

The type to be converted is an unsupported target pixel format.

**错误描述**

不支持图片转换目标类型。

**可能原因**

不支持该目标类型的转换。

**处理步骤**

更换图片或更换转换类型。

## 62980286 PixelMap设置内存标识符失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Memory format not supported.

**错误描述**

PixelMap设置内存标识符失败。

**可能原因**

1. PixelMap内存类型不匹配。
2. PixelMap的fd失效。
3. 未知的内核错误。

**处理步骤**

检查是否已释放PixelMap实例。检查内存类型是否匹配。

## 62980302 内存拷贝失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Memory copy failed.

**错误描述**

内存拷贝失败。

**可能原因**

1. 内存类型不匹配。
2. fd失效。
3. 未知的内核错误。

**处理步骤**

检查是否已释放要拷贝的实例。检查内存类型是否匹配。

## 7600101 不支持的MIME类型

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Unsupported mime type.

**错误描述**

不支持的MIME类型。

**可能原因**

设备不支持该MIME类型。

**处理步骤**

检查图片数据或更换图片，可使用相关接口查询编解码能力范围。

## 7600102 未知MIME类型

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Unknown mime type.

**错误描述**

未知的MIME类型。

**可能原因**

设备不支持该图像类型或图片损坏。

**处理步骤**

检查图片数据或更换图片。

## 7600103 数据或图片太大

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Too large data or image.

**错误描述**

数据或图片太大。

**可能原因**

图片尺寸太大。

**处理步骤**

更换较小的图片。

## 7600104 获取图像数据失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Failed to get the data from Surface.

**错误描述**

获取图像数据失败。

**可能原因**

1. 设备不支持该图像类型。
2. 图像数据损坏或丢失。

**处理步骤**

检查图像数据来源或使用新的图像数据。

## 7600105 PixelMap已被释放

> phone | 2in1 | tablet | tv | wearable

**错误信息**

PixelMap has been released.

**错误描述**

PixelMap已被释放。

**可能原因**

PixelMap对象已被释放，其关联的native对象已不存在。

**处理步骤**

检查该PixelMap对象是否存在被提前释放的风险（例如，在异步任务或另一个线程中意外释放），需确保该对象在使用结束前及所有异步方法执行完成前不被释放。

## 7600106 PixelMap已被传递至另一个线程

> phone | 2in1 | tablet | tv | wearable

**错误信息**

PixelMap has been passed to another thread.

**错误描述**

PixelMap已被传递至另一个线程。

**可能原因**

PixelMap对象已被传递至另一个线程，原线程的对象无法继续调用接口。

**处理步骤**

不要在PixelMap对象被传递到另一个线程后仍在原线程调用该对象的接口。

## 7600173 DMA内存不存在

> phone | 2in1 | tablet | tv | wearable

**错误信息**

DMA memory does not exist.

**错误描述**

DMA内存不存在。

**可能原因**

当前操作要求PixelMap使用DMA内存，但传入的PixelMap未使用DMA内存。例如，对共享内存的PixelMap读写HDR元数据，或获取其底层NativeBuffer。

**处理步骤**

重新创建使用DMA内存的PixelMap，并使用新对象调用原接口。根据输入数据选择创建方式：

* 解码图片：从API版本15开始，可调用[createPixelMapUsingAllocator](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-image-imagesource#createpixelmapusingallocator15)，将allocatorType设置为image.AllocatorType.DMA；C接口调用[OH_ImageSourceNative_CreatePixelmapUsingAllocator()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-image-source-native-h#oh_imagesourcenative_createpixelmapusingallocator)，将allocator设置为IMAGE_ALLOCATOR_TYPE_DMA。
* 从像素数据创建：从API版本20开始，可调用[image.createPixelMapUsingAllocator](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-image-f#imagecreatepixelmapusingallocator20)，将allocatorType设置为image.AllocatorType.DMA；C接口调用[OH_PixelmapNative_CreatePixelmapUsingAllocator()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-pixelmap-native-h#oh_pixelmapnative_createpixelmapusingallocator)，将allocator设置为IMAGE_ALLOCATOR_MODE_DMA。

关于DMA内存的更多说明，请参见[图片解码内存优化(ArkTS)](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/image-allocator-type)和[图片解码内存优化(C/C++)](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/image-allocator-type-c)。

## 7600174 DMA操作失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

DMA operation failed.

**错误描述**

DMA内存操作失败。

**可能原因**

读写DMA内存时没有正确地进行同步操作。

**处理步骤**

使用正确的方式读写DMA内存。

## 7600201 不支持的操作

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Unsupported operation, e.g. on cross-platform.

**错误描述**

不支持的操作。如：修改一个Editable属性为false的PixelMap等。

**可能原因**

不支持的操作。如：修改一个Editable属性为false的PixelMap等。

**处理步骤**

使用支持的操作。

## 7600202 不支持的元数据读写

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Unsupported metadata. Possible causes: Unsupported metadata type.

**错误描述**

不支持的元数据读写。

**可能原因**

不支持的元数据读写，如不支持的Exif字段，对类型不符的辅助图，获取特定辅助图元数据，如对深度图获取GainmapMetadata。

**处理步骤**

重新确定辅助图类型和元数据类型是否对应，再进行读写操作。

## 7600203 不支持的转换

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Unsupported conversion.

**错误描述**

不支持的转换。

**可能原因**

PixelMap的格式不支持转换。

**处理步骤**

检查并更换格式匹配的PixelMap数据。

## 7600204 无效的区域

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Invalid region.

**错误描述**

无效的区域。

**可能原因**

Region中设置的顶点位置、宽度或高度超出图片尺寸范围。

**处理步骤**

检查Region中设置的顶点位置、宽度或高度，确保在图片尺寸范围之内。

## 7600205 不支持的内存格式或像素格式

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Unsupported memory format or pixel format.

**错误描述**

不支持的内存格式或像素格式。

**可能原因**

接口不支持当前PixelMap的内存格式或像素格式。

**处理步骤**

查看接口的规格限制，并检查PixelMap的内存格式或像素格式，使用格式支持的PixelMap调用接口。

## 7600206 无效参数

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Invalid parameter.

**错误描述**

非法参数。

**可能原因**

输入的参数无效。

**处理步骤**

检查并重新输入正确的参数。

## 7600207 不支持的数据格式

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Unsupported data format.

**错误描述**

不支持的数据格式。

**可能原因**

1. 接口不支持传入的像素数据格式。
2. 对象中的数据格式不支持特定的操作。

**处理步骤**

查看接口文档并使用接口支持的数据格式。

## 7600208 HDR图片分解失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

HDR image decomposition failed. Possible causes: 1. Decomposition processing is not supported. 2. Processing error occurs.

**错误描述**

HDR图片分解失败。

**可能原因**

1. 分解处理不被支持。
2. HDR图片处理过程中发生错误。

**处理步骤**

检查HDR PixelMap的像素格式是否支持分解，或更换图片后重试。

## 7600301 申请内存失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Memory alloc failed.

**错误描述**

申请内存失败。

**可能原因**

设备内存不足或内存被占用。

**处理步骤**

清理内存后重试。

## 7600302 内存拷贝失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Memory copy failed.

**错误描述**

内存拷贝失败。

**可能原因**

拷贝的内存不存在，设备内存不足。

**处理步骤**

检查要拷贝的内存是否存在，清理内存后重试。

## 7600303 内存锁定或解锁失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Memory lock or unlock failed.

**错误描述**

内存锁定或解锁失败。

**可能原因**

PixelMap或内存地址无效。

**处理步骤**

检查PixelMap或内存地址是否有效。

## 7600305 创建PixelMap失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Failed to create the PixelMap.

**错误描述**

创建PixelMap失败。

**可能原因**

1. 参数错误（如区域范围超出、入参值非法等）导致的创建失败。
2. 错误地提前释放实例，导致实例创建失败。

**处理步骤**

检查函数入参或检查是否提前释放了实例。

## 7600306 数据转换失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Data conversion failed.

**错误描述**

数据转换失败。

**可能原因**

1. 传入的像素数据缓冲区的大小不符合预期。
2. PixelMap内部的像素数据损坏。

**处理步骤**

1. 如果传入了一个缓冲区，检查缓冲区的大小是否符合预期。
2. 检查PixelMap的像素数据和元数据是否正常。

## 7600501 不支持的分配器模式

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Unsupported allocator mode, e.g., use share memory to create a HDR image as only DMA supported hdr metadata.

**错误描述**

不支持的分配器模式。

**可能原因**

没有指定内存分配类型，或指定了错误的内存分配类型。例如：使用共享内存方式解码HDR图片就会出错，因为只有DMA方式才支持HDR元数据。

**处理步骤**

使用正确的内存分配类型。

## 7600901 未知错误

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Unknown error.

**错误描述**

未知错误。

**可能原因**

未知原因引起的错误。

**处理步骤**

通过日志查找原因。

## 7700101 图片源存在问题

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Bad source.

**错误描述**

图片源存在问题。

**可能原因**

1. 设备不支持该图片类型。
2. 没有按指示操作进行图片解码。
3. 图源数据不完整。从API version 17开始，系统底层经过优化，当遇到不完整数据时，系统将尝试部分解码，尽可能输出已解析的有效像素数据。但是如果图源数据文件头信息（如图像尺寸、颜色配置等）不完整，或图片像素数据块缺失严重，则仍会导致系统无法正常解码，最终返回解码失败。当前仅支持jpeg、png、bmp格式图片的不完整解码。

**处理步骤**

检查图片数据或更换图片。

## 7700102 不支持的MIME类型

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Unsupported MIME type.

**错误描述**

不支持的MIME类型。

**可能原因**

设备不支持该图片类型。

**处理步骤**

检查图片数据或更换图片。

## 7700103 图片太大

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Image too large.

**错误描述**

图片太大。

**可能原因**

图片大小超出限制。

**处理步骤**

检查图片数据或更换图片。

## 7700201 不支持的内存分配类型

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Unsupported allocator type, e.g., use share memory to decode a HDR image as only DMA supported hdr metadata.

**错误描述**

不支持的内存分配类型。

**可能原因**

没有指定内存分配类型，或指定了错误的内存分配类型。例如：使用共享内存方式解码HDR图片就会出错，因为只有DMA方式才支持HDR元数据。

**处理步骤**

使用正确的内存分配类型。

## 7700202 不支持的元数据

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Unsupported metadata.

**错误描述**

不支持的元数据。

**可能原因**

1. 输入了不支持的元数据字段。
2. 元数据字段对应的值非法。

**处理步骤**

检查元数据字段是否支持或检查元数据值是否合法。

## 7700203 不支持的选项

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Unsupported options, e.g., cannot convert image into desired pixel format.

**错误描述**

不支持的选项。

**可能原因**

部分选项参数配置存在错误，不支持该选项要求的操作。

**处理步骤**

检查选项参数配置。

## 7700204 无效参数

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Invalid parameter.

**错误描述**

非法参数。

**可能原因**

输入的参数无效。

**处理步骤**

检查并重新输入正确的参数。

## 7700301 解码失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Decode failed.

**错误描述**

解码失败。

**可能原因**

1. 设备的内存不足。
2. 设备不支持该图片类型。
3. 没有按指示操作进行图片解码。

**处理步骤**

检查图片数据或更换图片。

## 7700302 内存分配失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Memory allocation failed.

**错误描述**

内存分配失败。

**可能原因**

1. 设备的内存不足。
2. 没有按指示操作进行图片解码。

**处理步骤**

检查设备内存或检查传入数据。

## 7700303 图片不包含缩略图数据

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Image does not carry thumbnail data.

**错误描述**

图片不包含缩略图数据。

**可能原因**

图片文件中不包含缩略图数据，且未开启缩略图生成功能。

**处理步骤**

检查图片文件是否包含缩略图数据，或开启缩略图生成功能后重试。

## 7700305 缩略图生成失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Thumbnail generation failed.

**错误描述**

缩略图生成失败。

**可能原因**

1. 输入图片数据异常。
2. 缩略图生成参数不合理。
3. 设备资源不足。

**处理步骤**

检查输入图片数据和缩略图生成参数，必要时释放系统资源后重试。

## 7700304 图片信息写入文件失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Failed to write image properties to the file.

**错误描述**

图片信息写入文件失败。

**可能原因**

1. 图片数据错误。
2. 没有修改图片文件的权限。

**处理步骤**

检查图片数据或检查图片文件权限。

## 7800201 不支持的选项

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Unsupported options.

**错误描述**

不支持的选项。

**可能原因**

部分选项参数配置存在错误，不支持该选项要求的操作。

**处理步骤**

检查选项参数配置。

## 7800202 ImagePacker无效参数

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Invalid parameter for ImagePacker.

**错误描述**

编码参数无效。

**可能原因**

编码参数为空或无效。

**处理步骤**

检查编码选项参数配置。

## 7800301 编码失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Encode failed.

**错误描述**

编码失败。

**可能原因**

1. 设置的编码格式不支持。
2. 传入数据不正确。

**处理步骤**

更换图片或检查传入数据。

## 7900201 无效参数

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Invalid parameter.

**错误描述**

非法参数。

**可能原因**

1. 传入的参数数量、类型不正确。
2. 设置的图像格式不支持。

**处理步骤**

检查参数配置。