1# media_asset_capi.h 2 3## 概述 4 5定义与媒体资源相关的API。提供获取图像或视频信息的能力。 6 7**库：** libmedia_asset_manager.so 8 9**引用文件：** <multimedia/media_library/media_asset_capi.h> 10 11**系统能力：** SystemCapability.FileManagement.PhotoAccessHelper.Core 12 13**起始版本：** 12 14 15**相关模块：** [MediaAssetManager](capi-mediaassetmanager.md) 16 17## 汇总 18 19### 函数 20 21| 名称 | 描述 | 22| -- | -- | 23| [MediaLibrary_ErrorCode OH_MediaAsset_GetUri(OH_MediaAsset* mediaAsset, const char** uri)](#oh_mediaasset_geturi) | 获取媒体资产的uri。 | 24| [MediaLibrary_ErrorCode OH_MediaAsset_GetMediaType(OH_MediaAsset* mediaAsset, MediaLibrary_MediaType* mediaType)](#oh_mediaasset_getmediatype) | 获取媒体资源类型。 | 25| [MediaLibrary_ErrorCode OH_MediaAsset_GetMediaSubType(OH_MediaAsset* mediaAsset, MediaLibrary_MediaSubType* mediaSubType)](#oh_mediaasset_getmediasubtype) | 获取媒体资源子类型。 | 26| [MediaLibrary_ErrorCode OH_MediaAsset_GetDisplayName(OH_MediaAsset* mediaAsset, const char** displayName)](#oh_mediaasset_getdisplayname) | 获取媒体资源的显示名称。 | 27| [MediaLibrary_ErrorCode OH_MediaAsset_GetSize(OH_MediaAsset* mediaAsset, uint32_t* size)](#oh_mediaasset_getsize) | 获取媒体资产的文件大小。 | 28| [MediaLibrary_ErrorCode OH_MediaAsset_GetDateAdded(OH_MediaAsset* mediaAsset, uint32_t* dateAdded)](#oh_mediaasset_getdateadded) | 获取资产添加日期。 | 29| [MediaLibrary_ErrorCode OH_MediaAsset_GetDateModified(OH_MediaAsset* mediaAsset, uint32_t* dateModified)](#oh_mediaasset_getdatemodified) | 获取资产的修改日期。 | 30| [MediaLibrary_ErrorCode OH_MediaAsset_GetDateTaken(OH_MediaAsset* mediaAsset, uint32_t* dateTaken)](#oh_mediaasset_getdatetaken) | 获取资产的拍摄日期。 | 31| [MediaLibrary_ErrorCode OH_MediaAsset_GetDateAddedMs(OH_MediaAsset* mediaAsset, uint32_t* dateAddedMs)](#oh_mediaasset_getdateaddedms) | 获取资产的添加时间（毫秒）。 | 32| [MediaLibrary_ErrorCode OH_MediaAsset_GetDateModifiedMs(OH_MediaAsset* mediaAsset, uint32_t* dateModifiedMs)](#oh_mediaasset_getdatemodifiedms) | 获取资产的修改时间（毫秒）。 | 33| [MediaLibrary_ErrorCode OH_MediaAsset_GetDuration(OH_MediaAsset* mediaAsset, uint32_t* duration)](#oh_mediaasset_getduration) | 获取媒体资源的持续时间（毫秒）。 | 34| [MediaLibrary_ErrorCode OH_MediaAsset_GetWidth(OH_MediaAsset* mediaAsset, uint32_t* width)](#oh_mediaasset_getwidth) | 获取媒体资源的图像宽度（像素）。 | 35| [MediaLibrary_ErrorCode OH_MediaAsset_GetHeight(OH_MediaAsset* mediaAsset, uint32_t* height)](#oh_mediaasset_getheight) | 获取媒体资源的图像高度（像素）。 | 36| [MediaLibrary_ErrorCode OH_MediaAsset_GetOrientation(OH_MediaAsset* mediaAsset, uint32_t* orientation)](#oh_mediaasset_getorientation) | 获取图像的旋转角度，单位为度。 | 37| [MediaLibrary_ErrorCode OH_MediaAsset_IsFavorite(OH_MediaAsset* mediaAsset, uint32_t* favorite)](#oh_mediaasset_isfavorite) | 获取资产的收藏状态。 | 38| [MediaLibrary_ErrorCode OH_MediaAsset_GetTitle(OH_MediaAsset* mediaAsset, const char** title)](#oh_mediaasset_gettitle) | 获取媒体资产的标题。 | 39| [MediaLibrary_ErrorCode OH_MediaAsset_Release(OH_MediaAsset* mediaAsset)](#oh_mediaasset_release) | 释放媒体资产。 | 40 41## 函数说明 42 43### OH_MediaAsset_GetUri() 44 45``` 46MediaLibrary_ErrorCode OH_MediaAsset_GetUri(OH_MediaAsset* mediaAsset, const char** uri) 47``` 48 49**描述** 50 51获取媒体资产的uri。 52 53**起始版本：** 12 54 55 56**参数：** 57 58| 参数项 | 描述 | 59| -- | -- | 60| [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)* mediaAsset | [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)实例。 | 61| const char** uri | 媒体资产的uri。 | 62 63**返回：** 64 65| 类型 | 说明 | 66| -- | -- | 67| [MediaLibrary_ErrorCode](capi-media-asset-base-capi-h.md#medialibrary_errorcode) | MEDIA_LIBRARY_OK：方法调用成功。<br> MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：<br> 1. 未指定强制参数。<br> 2. 参数类型不正确。<br> 3. 参数验证失败。<br> MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。 | 68 69### OH_MediaAsset_GetMediaType() 70 71``` 72MediaLibrary_ErrorCode OH_MediaAsset_GetMediaType(OH_MediaAsset* mediaAsset, MediaLibrary_MediaType* mediaType) 73``` 74 75**描述** 76 77获取媒体资源类型。 78 79**起始版本：** 13 80 81 82**参数：** 83 84| 参数项 | 描述 | 85| -- | -- | 86| [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)* mediaAsset | [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)实例。 | 87| [MediaLibrary_MediaType](capi-media-asset-base-capi-h.md#medialibrary_mediatype)* mediaType | 媒体资源类型。 | 88 89**返回：** 90 91| 类型 | 说明 | 92| -- | -- | 93| [MediaLibrary_ErrorCode](capi-media-asset-base-capi-h.md#medialibrary_errorcode) | MEDIA_LIBRARY_OK：方法调用成功。<br> MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：<br> 1. 未指定强制参数。<br> 2. 参数类型不正确。<br> 3. 参数验证失败。<br> MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。 | 94 95### OH_MediaAsset_GetMediaSubType() 96 97``` 98MediaLibrary_ErrorCode OH_MediaAsset_GetMediaSubType(OH_MediaAsset* mediaAsset,MediaLibrary_MediaSubType* mediaSubType) 99``` 100 101**描述** 102 103获取媒体资源子类型。 104 105**起始版本：** 13 106 107 108**参数：** 109 110| 参数项 | 描述 | 111| -- | -- | 112| [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)* mediaAsset | [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)实例。 | 113| [MediaLibrary_MediaSubType](capi-media-asset-base-capi-h.md#medialibrary_mediasubtype)* mediaSubType | 媒体资源子类型。 | 114 115**返回：** 116 117| 类型 | 说明 | 118| -- | -- | 119| [MediaLibrary_ErrorCode](capi-media-asset-base-capi-h.md#medialibrary_errorcode) | MEDIA_LIBRARY_OK：方法调用成功。<br> MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：<br> 1. 未指定强制参数。<br> 2. 参数类型不正确。<br> 3. 参数验证失败。<br> MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。 | 120 121### OH_MediaAsset_GetDisplayName() 122 123``` 124MediaLibrary_ErrorCode OH_MediaAsset_GetDisplayName(OH_MediaAsset* mediaAsset, const char** displayName) 125``` 126 127**描述** 128 129获取媒体资源的显示名称。 130 131**起始版本：** 12 132 133 134**参数：** 135 136| 参数项 | 描述 | 137| -- | -- | 138| [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)* mediaAsset | [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)实例。 | 139| const char** displayName | 媒体资源的显示名称。 | 140 141**返回：** 142 143| 类型 | 说明 | 144| -- | -- | 145| [MediaLibrary_ErrorCode](capi-media-asset-base-capi-h.md#medialibrary_errorcode) | MEDIA_LIBRARY_OK：方法调用成功。<br> MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：<br> 1. 未指定强制参数。<br> 2. 参数类型不正确。<br> 3. 参数验证失败。<br> MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。 | 146 147### OH_MediaAsset_GetSize() 148 149``` 150MediaLibrary_ErrorCode OH_MediaAsset_GetSize(OH_MediaAsset* mediaAsset, uint32_t* size) 151``` 152 153**描述** 154 155获取媒体资产的文件大小。 156 157**起始版本：** 12 158 159 160**参数：** 161 162| 参数项 | 描述 | 163| -- | -- | 164| [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)* mediaAsset | [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)实例。 | 165| uint32_t* size | 媒体资源的文件大小（以字节为单位）。 | 166 167**返回：** 168 169| 类型 | 说明 | 170| -- | -- | 171| [MediaLibrary_ErrorCode](capi-media-asset-base-capi-h.md#medialibrary_errorcode) | MEDIA_LIBRARY_OK：方法调用成功。<br> MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：<br> 1. 未指定强制参数。<br> 2. 参数类型不正确。<br> 3. 参数验证失败。<br> MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。 | 172 173### OH_MediaAsset_GetDateAdded() 174 175``` 176MediaLibrary_ErrorCode OH_MediaAsset_GetDateAdded(OH_MediaAsset* mediaAsset, uint32_t* dateAdded) 177``` 178 179**描述** 180 181获取资产添加日期。 182 183**起始版本：** 13 184 185 186**参数：** 187 188| 参数项 | 描述 | 189| -- | -- | 190| [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)* mediaAsset | [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)实例。 | 191| uint32_t* dateAdded | 资产添加日期。该值是添加文件时间距1970年1月1日的秒数值。 | 192 193**返回：** 194 195| 类型 | 说明 | 196| -- | -- | 197| [MediaLibrary_ErrorCode](capi-media-asset-base-capi-h.md#medialibrary_errorcode) | MEDIA_LIBRARY_OK：方法调用成功。<br> MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：<br> 1. 未指定强制参数。<br> 2. 参数类型不正确。<br> 3. 参数验证失败。<br> MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。 | 198 199### OH_MediaAsset_GetDateModified() 200 201``` 202MediaLibrary_ErrorCode OH_MediaAsset_GetDateModified(OH_MediaAsset* mediaAsset, uint32_t* dateModified) 203``` 204 205**描述** 206 207获取资产的修改日期。 208 209**起始版本：** 13 210 211 212**参数：** 213 214| 参数项 | 描述 | 215| -- | -- | 216| [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)* mediaAsset | [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)实例。 | 217| uint32_t* dateModified | 资产的修改日期。该值是修改文件时间距1970年1月1日的秒数值，修改文件名不会改变此值，当文件内容发生修改时才会更新。 | 218 219**返回：** 220 221| 类型 | 说明 | 222| -- | -- | 223| [MediaLibrary_ErrorCode](capi-media-asset-base-capi-h.md#medialibrary_errorcode) | MEDIA_LIBRARY_OK：方法调用成功。<br> MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：<br> 1. 未指定强制参数。<br> 2. 参数类型不正确。<br> 3. 参数验证失败。<br> MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。 | 224 225### OH_MediaAsset_GetDateTaken() 226 227``` 228MediaLibrary_ErrorCode OH_MediaAsset_GetDateTaken(OH_MediaAsset* mediaAsset, uint32_t* dateTaken) 229``` 230 231**描述** 232 233获取资产的拍摄日期。 234 235**起始版本：** 13 236 237 238**参数：** 239 240| 参数项 | 描述 | 241| -- | -- | 242| [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)* mediaAsset | [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)实例。 | 243| uint32_t* dateTaken | 资产的拍摄日期。该值是文件拍照时间距1970年1月1日的秒数值。 | 244 245**返回：** 246 247| 类型 | 说明 | 248| -- | -- | 249| [MediaLibrary_ErrorCode](capi-media-asset-base-capi-h.md#medialibrary_errorcode) | MEDIA_LIBRARY_OK：方法调用成功。<br> MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：<br> 1. 未指定强制参数。<br> 2. 参数类型不正确。<br> 3. 参数验证失败。<br> MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。 | 250 251### OH_MediaAsset_GetDateAddedMs() 252 253``` 254MediaLibrary_ErrorCode OH_MediaAsset_GetDateAddedMs(OH_MediaAsset* mediaAsset, uint32_t* dateAddedMs) 255``` 256 257**描述** 258 259获取资产的添加时间（毫秒）。 260 261**起始版本：** 13 262 263 264**参数：** 265 266| 参数项 | 描述 | 267| -- | -- | 268| [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)* mediaAsset | [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)实例。 | 269| uint32_t* dateAddedMs | 资产的添加时间（毫秒）。该值是添加文件时间距1970年1月1日的毫秒数值。 | 270 271**返回：** 272 273| 类型 | 说明 | 274| -- | -- | 275| [MediaLibrary_ErrorCode](capi-media-asset-base-capi-h.md#medialibrary_errorcode) | MEDIA_LIBRARY_OK：方法调用成功。<br> MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：<br> 1. 未指定强制参数。<br> 2. 参数类型不正确。<br> 3. 参数验证失败。<br> MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。 | 276 277### OH_MediaAsset_GetDateModifiedMs() 278 279``` 280MediaLibrary_ErrorCode OH_MediaAsset_GetDateModifiedMs(OH_MediaAsset* mediaAsset, uint32_t* dateModifiedMs) 281``` 282 283**描述** 284 285获取资产的修改时间（毫秒）。 286 287**起始版本：** 12 288 289 290**参数：** 291 292| 参数项 | 描述 | 293| -- | -- | 294| [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)* mediaAsset | [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)实例。 | 295| uint32_t* dateModifiedMs | 资产的修改时间（毫秒）。该值是修改文件时间距1970年1月1日的毫秒数值，修改文件名不会改变此值，当文件内容发生修改时才会更新。 | 296 297**返回：** 298 299| 类型 | 说明 | 300| -- | -- | 301| [MediaLibrary_ErrorCode](capi-media-asset-base-capi-h.md#medialibrary_errorcode) | MEDIA_LIBRARY_OK：方法调用成功。<br> MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：<br> 1. 未指定强制参数。<br> 2. 参数类型不正确。<br> 3. 参数验证失败。<br> MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。 | 302 303### OH_MediaAsset_GetDuration() 304 305``` 306MediaLibrary_ErrorCode OH_MediaAsset_GetDuration(OH_MediaAsset* mediaAsset, uint32_t* duration) 307``` 308 309**描述** 310 311获取媒体资源的持续时间（毫秒）。 312 313**起始版本：** 13 314 315 316**参数：** 317 318| 参数项 | 描述 | 319| -- | -- | 320| [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)* mediaAsset | [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)实例。 | 321| uint32_t* duration | 媒体资源的持续时间（毫秒）。 | 322 323**返回：** 324 325| 类型 | 说明 | 326| -- | -- | 327| [MediaLibrary_ErrorCode](capi-media-asset-base-capi-h.md#medialibrary_errorcode) | MEDIA_LIBRARY_OK：方法调用成功。<br> MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：<br> 1. 未指定强制参数。<br> 2. 参数类型不正确。<br> 3. 参数验证失败。<br> MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。 | 328 329### OH_MediaAsset_GetWidth() 330 331``` 332MediaLibrary_ErrorCode OH_MediaAsset_GetWidth(OH_MediaAsset* mediaAsset, uint32_t* width) 333``` 334 335**描述** 336 337获取媒体资源的图像宽度（像素）。 338 339**起始版本：** 12 340 341 342**参数：** 343 344| 参数项 | 描述 | 345| -- | -- | 346| [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)* mediaAsset | [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)实例。 | 347| uint32_t* width | 媒体资源的图像宽度（像素）。 | 348 349**返回：** 350 351| 类型 | 说明 | 352| -- | -- | 353| [MediaLibrary_ErrorCode](capi-media-asset-base-capi-h.md#medialibrary_errorcode) | MEDIA_LIBRARY_OK：方法调用成功。<br> MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：<br> 1. 未指定强制参数。<br> 2. 参数类型不正确。<br> 3. 参数验证失败。<br> MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。 | 354 355### OH_MediaAsset_GetHeight() 356 357``` 358MediaLibrary_ErrorCode OH_MediaAsset_GetHeight(OH_MediaAsset* mediaAsset, uint32_t* height) 359``` 360 361**描述** 362 363获取媒体资源的图像高度（像素）。 364 365**起始版本：** 12 366 367 368**参数：** 369 370| 参数项 | 描述 | 371| -- | -- | 372| [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)* mediaAsset | [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)实例。 | 373| uint32_t* height | 媒体资源的图像高度（像素）。 | 374 375**返回：** 376 377| 类型 | 说明 | 378| -- | -- | 379| [MediaLibrary_ErrorCode](capi-media-asset-base-capi-h.md#medialibrary_errorcode) | MEDIA_LIBRARY_OK：方法调用成功。<br> MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：<br> 1. 未指定强制参数。<br> 2. 参数类型不正确。<br> 3. 参数验证失败。<br> MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。 | 380 381### OH_MediaAsset_GetOrientation() 382 383``` 384MediaLibrary_ErrorCode OH_MediaAsset_GetOrientation(OH_MediaAsset* mediaAsset, uint32_t* orientation) 385``` 386 387**描述** 388 389获取图像的旋转角度，单位为度。 390 391**起始版本：** 12 392 393 394**参数：** 395 396| 参数项 | 描述 | 397| -- | -- | 398| [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)* mediaAsset | [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)实例。 | 399| uint32_t* orientation | 图像的旋转角度，单位为度。 | 400 401**返回：** 402 403| 类型 | 说明 | 404| -- | -- | 405| [MediaLibrary_ErrorCode](capi-media-asset-base-capi-h.md#medialibrary_errorcode) | MEDIA_LIBRARY_OK：方法调用成功。<br> MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：<br> 1. 未指定强制参数。<br> 2. 参数类型不正确。<br> 3. 参数验证失败。<br> MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。 | 406 407### OH_MediaAsset_IsFavorite() 408 409``` 410MediaLibrary_ErrorCode OH_MediaAsset_IsFavorite(OH_MediaAsset* mediaAsset, uint32_t* favorite) 411``` 412 413**描述** 414 415获取资产的收藏状态。 416 417**起始版本：** 13 418 419 420**参数：** 421 422| 参数项 | 描述 | 423| -- | -- | 424| [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)* mediaAsset | [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)实例。 | 425| uint32_t* favorite | 资产的收藏状态。 | 426 427**返回：** 428 429| 类型 | 说明 | 430| -- | -- | 431| [MediaLibrary_ErrorCode](capi-media-asset-base-capi-h.md#medialibrary_errorcode) | MEDIA_LIBRARY_OK：方法调用成功。<br> MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：<br> 1. 未指定强制参数。<br> 2. 参数类型不正确。<br> 3. 参数验证失败。<br> MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。 | 432 433### OH_MediaAsset_GetTitle() 434 435``` 436MediaLibrary_ErrorCode OH_MediaAsset_GetTitle(OH_MediaAsset* mediaAsset, const char** title) 437``` 438 439**描述** 440 441获取媒体资产的标题。 442 443**起始版本：** 13 444 445 446**参数：** 447 448| 参数项 | 描述 | 449| -- | -- | 450| [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)* mediaAsset | [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)实例。 | 451| const char** title | 媒体资产的标题。 | 452 453**返回：** 454 455| 类型 | 说明 | 456| -- | -- | 457| [MediaLibrary_ErrorCode](capi-media-asset-base-capi-h.md#medialibrary_errorcode) | MEDIA_LIBRARY_OK：方法调用成功。<br> MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：<br> 1. 未指定强制参数。<br> 2. 参数类型不正确。<br> 3. 参数验证失败。<br> MEDIA_LIBRARY_INTERNAL_SYSTEM_ERROR：内部系统错误。 | 458 459### OH_MediaAsset_Release() 460 461``` 462MediaLibrary_ErrorCode OH_MediaAsset_Release(OH_MediaAsset* mediaAsset) 463``` 464 465**描述** 466 467释放媒体资产。 468 469**起始版本：** 12 470 471 472**参数：** 473 474| 参数项 | 描述 | 475| -- | -- | 476| [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)* mediaAsset | [OH_MediaAsset](capi-mediaassetmanager-oh-mediaasset.md)实例。 | 477 478**返回：** 479 480| 类型 | 说明 | 481| -- | -- | 482| [MediaLibrary_ErrorCode](capi-media-asset-base-capi-h.md#medialibrary_errorcode) | MEDIA_LIBRARY_OK：方法调用成功。<br> MEDIA_LIBRARY_PARAMETER_ERROR：参数错误。可能的原因：<br> 1. 未指定强制参数。<br> 2. 参数类型不正确。<br> 3. 参数验证失败。 | 483 484 485