# OH_AuxiliaryPictureInfo

```
typedef struct OH_AuxiliaryPictureInfo OH_AuxiliaryPictureInfo
```

#### 概述

AuxiliaryPictureInfo结构体类型，用于执行AuxiliaryPictureInfo相关操作。

使用OH\_AuxiliaryPictureInfo\_Create函数创建OH\_AuxiliaryPictureInfo对象。

使用OH\_AuxiliaryPictureNative\_GetInfo函数从OH\_AuxiliaryPictureNative对象中获取OH\_AuxiliaryPictureInfo对象。

使用OH\_AuxiliaryPictureInfo\_Release函数释放OH\_AuxiliaryPictureInfo对象。

使用约束：使用OH\_AuxiliaryPictureInfo对象前，需先创建或获取对象；使用完成后，应调用OH\_AuxiliaryPictureInfo\_Release释放对象。调用OH\_AuxiliaryPictureInfo\_GetType、OH\_AuxiliaryPictureInfo\_GetSize、OH\_AuxiliaryPictureInfo\_GetRowStride或OH\_AuxiliaryPictureInfo\_GetPixelFormat时，输出参数不允许传入nullptr；接口返回失败时，输出参数的内容不能在后续流程中继续使用。只有在明确辅助图实际状态与OH\_AuxiliaryPictureInfo对象信息不一致或有明确业务诉求时，才需要手动设置OH\_AuxiliaryPictureInfo。

资源管理：OH\_AuxiliaryPictureNative\_GetInfo成功返回的OH\_AuxiliaryPictureInfo对象由调用方管理。通过OH\_AuxiliaryPictureNative\_SetInfo设置辅助图信息时，接口会读取并保存OH\_AuxiliaryPictureInfo中的信息值，接口返回后调用方仍需自行管理该OH\_AuxiliaryPictureInfo对象的生命周期。

OH\_AuxiliaryPictureInfo结构体内容和操作方式如下：

| 字段类型 | 字段名称 | 字段描述 | 字段获取函数 | 字段设置函数 |
| --- | --- | --- | --- | --- |
| Image_AuxiliaryPictureType | type | 辅助图类型。 | OH_AuxiliaryPictureInfo_GetType | OH_AuxiliaryPictureInfo_SetType |
| Image_Size | size | 辅助图尺寸。 | OH_AuxiliaryPictureInfo_GetSize | OH_AuxiliaryPictureInfo_SetSize |
| uint32_t | rowStride | 行跨距，内存中每行像素所占的空间。 | OH_AuxiliaryPictureInfo_GetRowStride | OH_AuxiliaryPictureInfo_SetRowStride |
| PIXEL_FORMAT | pixelFormat | 像素格式。 | OH_AuxiliaryPictureInfo_GetPixelFormat | OH_AuxiliaryPictureInfo_SetPixelFormat |

**起始版本：** 13

**相关模块：** Image\_NativeModule

**所在头文件：** picture\_native.h

**相关开发指导：** 使用Image\_NativeModule完成多图对象解码