1# Image Error Codes 2<!--Kit: Image Kit--> 3<!--Subsystem: Multimedia--> 4<!--Owner: @aulight02--> 5<!--SE: @liyang_bryan--> 6<!--TSE: @xchaosioda--> 7 8 9> **NOTE** 10> 11> This topic describes only module-specific error codes. For details about universal error codes, see [Universal Error Codes](../errorcode-universal.md). 12 13## 501 API Call Failed 14 15**Error Message** 16 17Resource unavailable. 18 19**Possible Cause** 20 21The image is transferred across threads, and the original object cannot call the API. 22 23**Solution** 24 25Check the image and follow the instructions to decode it. 26 27## 62980096 Operation Failed 28 29**Error Message** 30 31Transaction operation failed. 32 33**Possible Cause** 34 351. An exception occurs during image upload. 362. Other operations are performed during decoding. 373. Image decoding is not performed as instructed. 384. The memory of the device is insufficient. 395. The processing on the decoding library fails. 40 41**Solution** 42 43Check the image and follow the instructions to decode it. 44 45## 62980097 PixelMap Serialization Failed 46 47**Error Message** 48 49RPC error. 50 51**Possible Cause** 52 531. An exception occurs during image upload. 542. Other operations are performed during decoding. 553. Image decoding is not performed as instructed. 564. The memory of the device is insufficient. 57 58**Solution** 59 60Check the image and follow the instructions to decode it. 61 62## 62980098 Shared Memory Error 63 64**Error Message** 65 66Shared memory does not exist. 67 68**Possible Cause** 69 701. The size of the shared memory is insufficient. 712. It is out-of-bounds access to the shared memory. 723. An invalid pointer is used. 73 74**Solution** 75 76Check the memory usage or restart the device. 77 78## 62980099 Data Error in the Shared Memory 79 80**Error Message** 81 82Shared memory data abnormal. 83 84**Possible Cause** 85 861. The synchronization operation is not correctly performed when data is read from or written to the shared memory. 872. It is out-of-bounds access to the shared memory. 883. An invalid pointer is used. 89 90**Solution** 91 92Restart the device. 93 94## 62980100 Image Decoding Error 95 96**Error Message** 97 98Image decoding abnormal. 99 100**Possible Cause** 101 1021. An exception occurs during image upload. 1032. Other operations are performed during decoding. 1043. Image decoding is not performed as instructed. 1054. The memory of the device is insufficient. 106 107**Solution** 108 109Check the image and follow the instructions to decode it. 110 111## 62980101 Incorrect Input Image Data 112 113**Error Message** 114 115The image data is abnormal. 116 117**Possible Cause** 118 1191. The input image data is incorrect. 1202. The format of the image is incorrect. 1213. The size of the image is incorrect. 122 123**Solution** 124 125Use a valid image. 126 127## 62980102 Memory Allocation Error for Images 128 129**Error Message** 130 131Image malloc abnormal. 132 133**Possible Cause** 134 135The device memory is insufficient or occupied. 136 137**Solution** 138 139Clear the memory and try again. 140 141## 62980103 Unsupported Image Type 142 143**Error Message** 144 145Image types are not supported. 146 147**Possible Cause** 148 149The input image type is not supported. 150 151**Solution** 152 153Change the image type and try again. 154 155## 62980104 Image Initialization Error 156 157**Error Message** 158 159Image initialization abnormal. 160 161**Possible Cause** 162 1631. The image type is not supported. 1642. The image size is not supported. 1653. An error occurs during initialization. 166 167**Solution** 168 169Correct the parameters or user another image. 170 171## 62980105 Failure in Obtaining Image Data 172 173**Error Message** 174 175Failed to get the image data. 176 177**Possible Cause** 178 1791. The device does not support the image type. 1802. Image data is lost. 181 182**Solution** 183 184Correct the image data or use another image. 185 186## 62980106 Too Large Image Data 187 188**Error Message** 189 190The image data is too large. 191 192**Possible Cause** 193 194The image is too large. 195 196**Solution** 197 198Use a smaller image. 199 200## 62980107 Image Conversion Error 201 202**Error Message** 203 204Image conversion abnormal. 205 206**Possible Cause** 207 2081. Image conversion stops unexpectedly. 2092. Encoding parameters are incorrectly set. 210 211**Solution** 212 213Correct the encoding parameters or use another image. 214 215## 62980108 Image Color Conversion Error 216 217**Error Message** 218 219Image color conversion is abnormal. 220 221**Possible Cause** 222 2231. Color conversion is not supported for the image type. 2242. The device is faulty. 225 226**Solution** 227 228Try again or change the image type. 229 230## 62980109 Cropping Error 231 232**Error Message** 233 234Cropping exceptions. 235 236**Possible Cause** 237 2381. Cropping parameters are incorrectly set. 2392. The image data is incorrect. 240 241**Solution** 242 243Correct the cropping parameters or image data. 244 245## 62980110 Incorrect Image Source Data 246 247**Error Message** 248 249The image source data is abnormal. 250 251**Possible Cause** 252 253The image source data is missing or incorrect. 254 255**Solution** 256 257Check the operation procedure or use another image. 258 259## 62980111 Incomplete Image Source Data 260 261**Error Message** 262 263The image source data is incomplete. 264 265**Possible Cause** 266 267The image source data is missing. 268 269**Solution** 270 271Check the operation procedure or use another image. 272 273## 62980112 Image Format Mismatch 274 275**Error Message** 276 277The image format does not match. 278 279**Possible Cause** 280 281The image format does not match. 282 283**Solution** 284 285Use an image in a matched format. 286 287## 62980113 Unknown Image Format 288 289**Error Message** 290 291Unknown image format. 292 293**Possible Cause** 294 295The image format is not supported. 296 297**Solution** 298 299Use another image. 300 301## 62980114 Image Source Not Parsed 302 303**Error Message** 304 305Image source not parsed. 306 307**Possible Cause** 308 309The image source data is incorrect. 310 311**Solution** 312 313Correct the image source data. 314 315## 62980115 Invalid Image Parameter 316 317**Error Message** 318 319Invalid image parameter. 320 321**Possible Cause** 322 323An input parameter is invalid. 324 325**Solution** 326 327Correct the input parameter. 328 329## 62980116 Decoding Failure 330 331**Error Message** 332 333Decoding failed. 334 335**Possible Cause** 336 3371. The decoding process exits abnormally. 3382. The image format is not supported. 3393. No image is read. 340 341**Solution** 342 343Ensure that the image is read or use another image. 344 345## 62980117 Plugin Registration Failure 346 347**Error Message** 348 349Failed to register the plugin. 350 351**Possible Cause** 352 3531. No decoding or encoding plugin of the corresponding format is found. 3542. The data passed in is incorrect. 355 356**Solution** 357 358Correct the input data or use another image. 359 360## 62980118 Plugin Creation Failure 361 362**Error Message** 363 364Failed to create the plugin. 365 366**Possible Cause** 367 3681. No decoding or encoding plugin of the corresponding format is found. 3692. The data passed in is incorrect. 370 371**Solution** 372 373Correct the input data or use another image. 374 375## 62980119 Image Encoding Failure 376 377**Error Message** 378 379Image encoding failed. 380 381**Possible Cause** 382 3831. The encoding format is not supported. 3842. The data passed in is incorrect. 385 386**Solution** 387 388Correct the input data or use another image. 389 390## 62980120 Failure in Adding Pixel Mappings 391 392**Error Message** 393 394Failed to add the pixel mappings. 395 396**Possible Cause** 397 3981. Adding pixel mappings is not supported. 3992. An exception occurs during the addition of the pixel mapping. 400 401**Solution** 402 403Check the operation procedure or use another image. 404 405## 62980121 Hardware Decoding Not Supported 406 407**Error Message** 408 409Image hardware decoding is not supported. 410 411**Possible Cause** 412 413Image hardware decoding is used. 414 415**Solution** 416 417Use another decoding mode. 418 419## 62980122 Failure in Decoding the Image Header 420 421**Error Message** 422 423Failed to decode the image header. 424 425**Possible Cause** 426 4271. An exception occurs during the decoding of the image header. 4282. The image header does not meet the decoding requirements. 429 430**Solution** 431 432Correct the image data or use another image. 433 434## 62980123 EXIF Decoding Not Supported 435 436**Error Message** 437 438The image does not support EXIF decoding. 439 440**Possible Cause** 441 442The image does not support EXIF decoding. 443 444**Solution** 445 446Use another image. 447 448## 62980124 Missing Image Property 449 450**Error Message** 451 452The image property does not exist. 453 454**Possible Cause** 455 4561. The image property is missing. 4572. The image is modified improperly. 458 459**Solution** 460 461Use another image. 462 463## 62980133 Image Property Value Out of Range 464 465**Error Message** 466 467The EXIF data is out of range. 468 469**Possible Cause** 470 471The value of the image property is out of range. 472 473**Solution** 474 475Change the image or check the length of the image property value. 476 477## 62980135 Invalid Image Property Value 478 479**Error Message** 480 481The EXIF value is invalid. 482 483**Possible Cause** 484 485The image property is missing. 486 487**Solution** 488 489Correct the image data or use another image. 490 491## 62980137 Invalid Image Operation 492 493**Error Message** 494 495Invalid media operation. 496 497**Possible Cause** 498 499The current image format does not support this operation. 500 501**Solution** 502 503Use another image. 504 505## 62980146 Failed to Write Image Property Values to the File 506 507**Error Message** 508 509The EXIF data failed to be written to the file. 510 511**Possible Cause** 512 513The property values of the image are abnormal. 514 515**Solution** 516 517Use another image. 518 519## 62980149 Invalid Image Parameter 520 521**Error Message** 522 523Invalid MIME type for the image source. 524 525**Possible Cause** 526 527The current image format does not support this operation. 528 529**Solution** 530 531Use another image. 532 533## 62980172 Failed to Encode ICC 534 535**Error Message** 536 537Failed to encode icc. 538 539**Possible Cause** 540 541The image ICC information is incorrect. 542 543**Solution** 544 545Check the image data or use another image. 546 547## 62980173 DMA Memory Space Error 548 549**Error Message** 550 551The DMA memory does not exist. 552 553**Possible Cause** 554 5551. The size of the shared memory is insufficient. 5562. Out-of-bounds memory access occurs. 5573. An invalid pointer is used. 558 559**Solution** 560 561Check the memory usage or restart the device. 562 563## 62980174 Abnormal DMA Memory Data 564 565**Error Message** 566 567The DMA memory data is abnormal. 568 569**Possible Cause** 570 5711. The synchronization operation is not correctly performed when data is read from or written to the shared memory. 5722. Out-of-bounds memory access occurs. 5733. An invalid pointer is used. 574 575**Solution** 576 577Restart the device. 578 579## 62980177 Abnormal API Environment 580 581**Error Message** 582 583Abnormal API environment. 584 585**Possible Cause** 586 587The environment where the API is used is incorrect. 588 589**Solution** 590 591Check the SDK version. 592 593## 62980178 Failure in Creating a PixelMap 594 595**Error Message** 596 597Failed to create the PixelMap. 598 599**Possible Cause** 600 6011. Input parameters are incorrect. For example, the region size exceeds the upper limit or an invalid value is passed in. 6022. The instance is incorrectly released in advance. 603 604**Solution** 605 606Check whether the input parameters are correct and whether the instance is released in advance. 607 608## 62980179 Abnormal Buffer Size 609 610**Error Message** 611 612Abnormal buffer size. 613 614**Possible Cause** 615 616Input parameters are incorrect. For example, the region size exceeds the upper limit or an invalid value is passed in. 617 618**Solution** 619 620Check the input parameters. 621 622## 62980180 Failure in Mapping the File Descriptor 623 624**Error Message** 625 626FD mapping failed. 627 628**Possible Cause** 629 630The input file descriptor is incorrect. 631 632**Solution** 633 634Pass a correct file descriptor. 635 636## 62980246 Failure in Reading the PixelMap 637 638**Error Message** 639 640Failed to read the pixel map. 641 642**Possible Cause** 643 6441. The PixelMap data is incorrect. 6452. You do not have the permission to read data from the PixelMap. 646 647**Solution** 648 649Create another PixelMap or request the read permission. 650 651## 62980247 Failure in Writing the PixelMap 652 653**Error Message** 654 655Failed to write the pixel map. 656 657**Possible Cause** 658 6591. The PixelMap data is incorrect. 6602. You do not have the permission to write data to the PixelMap. 661 662**Solution** 663 664Create another PixelMap or request the write permission. 665 666## 62980248 No Modification to the PixelMap 667 668**Error Message** 669 670PixelMap does not allow modification. 671 672**Possible Cause** 673 674Users try to modify a PixelMap. 675 676**Solution** 677 678Do not modify the PixelMap. 679 680## 62980252 Failed to Create a Surface 681 682**Error Message** 683 684Failed to create surface. 685 686**Possible Cause** 687 688An error occurred when requesting memory for image encoding. 689 690**Solution** 691 692Try again or use another image. 693 694## 62980259 Incorrect Configuration 695 696**Error Message** 697 698Configuration error. 699 700**Possible Cause** 701 702The configuration is incorrect. 703 704**Solution** 705 706Correct the configuration. 707 708## 62980274 Failed to Convert Images 709 710**Error Message** 711 712The conversion failed. 713 714**Possible Cause** 715 7161. Image conversion stops unexpectedly. 7172. Encoding parameters are incorrectly set. 718 719**Solution** 720 721Correct the encoding parameters or use another image. 722 723## 62980276 Unsupported Image Conversion Target Type 724 725**Error Message** 726 727The type to be converted is an unsupported target pixel format. 728 729**Possible Cause** 730 731The conversion to the target type is not supported. 732 733**Solution** 734 735Use another image or change the target type. 736 737## 62980286 Failed to Set a Memory Identifier for a PixelMap 738 739**Error Message** 740 741Memory format not supported. 742 743**Possible Cause** 744 7451. The memory type of the PixelMap does not match. 7462. The FD of the PixelMap is invalid. 7473. Unknown kernel error. 748 749**Solution** 750 751Check whether the PixelMap instance has been released. Check whether the memory type matches. 752 753## 62980302 Memory Copy Failed 754 755**Error Message** 756 757Memory copy failed. 758 759**Possible Cause** 760 7611. The memory type does not match. 7622. The FD is invalid. 7633. Unknown kernel error. 764 765**Solution** 766 767Check whether the instance to be copied has been released. Check whether the memory type matches. 768 769## 7600201 Unsupported Operation 770 771**Error Message** 772 773Unsupported operation. 774 775**Possible Cause** 776 777The operation is not supported. 778 779**Solution** 780 781Use a supported operation. 782 783## 7600202 Unsupported Metadata Read/Write Operation 784 785**Error Message** 786 787Unsupported metadata. Possible causes: Unsupported metadata type. 788 789**Possible Cause** 790 791The metadata read/write operation is not supported. For example, the Exif field to read or write is not supported, or users attempt to obtain specific data from an auxiliary picture of an incorrect type (for example, attempt to obtain GainmapMetadata of a depth map). 792 793**Solution** 794 795Check whether the auxiliary picture type corresponds to the metadata type, and then perform the read and write operations. 796 797## 7600301 Memory Allocation Failure 798 799**Error Message** 800 801Memory alloc failed. 802 803**Possible Cause** 804 805The device memory is insufficient or occupied. 806 807**Solution** 808 809Clear the memory and try again. 810 811## 7600302 Memory Copy Failure 812 813**Error Message** 814 815Memory copy failed. 816 817**Possible Cause** 818 819The memory to copy does not exist, or the device memory is insufficient. 820 821**Solution** 822 823Check whether the memory to copy exists. Clear the memory and try again. 824 825## 7600901 Unknown Error 826 827**Error Message** 828 829Unknown error. 830 831**Possible Cause** 832 833Errors caused by unknown reasons. 834 835**Solution** 836 837Locate the cause based on logs. 838 839## 7700101 Abnormal Image Source 840 841**Error Message** 842 843Bad source. 844 845**Possible Cause** 846 8471. The device does not support the image type. 8482. Image decoding is not performed as instructed. 8493. The image source data is incomplete. Starting from API version 17, the system has been optimized at the underlying level. When encountering incomplete data, the system will attempt partial decoding to output as much valid pixel data as possible. However, if the file header information (such as image dimensions or color configuration) of the image source data is incomplete, or if there is a severe lack of image pixel data blocks, the system may still fail to decode the image properly, resulting in a decoding failure. Currently, only JPEG, PNG, and BMP image formats support partial decoding for incomplete data. 850 851**Solution** 852 853Check the image data or use another image. 854 855## 7700102 Unsupported MIME Type 856 857**Error Message** 858 859Unsupported mimetype. 860 861**Possible Cause** 862 863The device does not support the image type. 864 865**Solution** 866 867Check the image data or use another image. 868 869## 7700103 Image Oversized 870 871**Error Message** 872 873Image too large. 874 875**Possible Cause** 876 877The image size exceeds the upper limit. 878 879**Solution** 880 881Check the image data or use another image. 882 883## 7700201 Unsupported Memory Allocation Type 884 885**Error Message** 886 887Unsupported allocator type, e.g., use share memory to decode a HDR image as only DMA supported hdr metadata. 888 889**Possible Cause** 890 891No memory allocation type is specified, or an incorrect memory allocation type is specified. For example, an error occurs when an HDR image is decoded in shared memory mode, because only the DMA mode supports HDR metadata. 892 893**Solution** 894 895Use a correct memory allocation type. 896 897## 7700203 Unsupported Options 898 899**Error Message** 900 901Unsupported options, e.g, cannot convert image into desired pixel format. 902 903**Possible Cause** 904 905Some parameters are incorrectly configured, or the operation required by the options is not supported. 906 907**Solution** 908 909Check the parameter settings. 910 911## 7700301 Decoding Failure 912 913**Error Message** 914 915Decode failed. 916 917**Possible Cause** 918 9191. The memory of the device is insufficient. 9202. The device does not support the image type. 9213. Image decoding is not performed as instructed. 922 923**Solution** 924 925Check the image data or use another image. 926 927## 7700302 Memory Allocation Failed 928 929**Error Message** 930 931Memory allocation failed. 932 933**Possible Cause** 934 9351. The memory of the device is insufficient. 9362. Image decoding is not performed as instructed. 937 938**Solution** 939 940Check the device memory or input data. 941 942## 7800201 Unsupported Options 943 944**Error Message** 945 946Unsupported options. 947 948**Possible Cause** 949 950Some parameters are incorrectly configured, or the operation required by the options is not supported. 951 952**Solution** 953 954Check the parameter settings. 955 956## 7800301 Encoding Failure 957 958**Error Message** 959 960Encode failed. 961 962**Possible Cause** 963 9641. The encoding format is not supported. 9652. The data passed in is incorrect. 966 967**Solution** 968 969Correct the input data or use another image. 970