native_avmemory.h

概述

声明了媒体数据结构AVMemory的定义。

引用文件： <multimedia/player_framework/native_avmemory.h>

库： libnative_media_core.so

系统能力： SystemCapability.Multimedia.Media.Core

起始版本： 9

相关模块： Core

汇总

结构体

名称	typedef关键字	描述
OH_AVMemory	OH_AVMemory	为音视频内存接口定义native层对象。

函数

名称	描述
OH_AVMemory *OH_AVMemory_Create(int32_t size)	创建OH_AVMemory实例的指针。
uint8_t OH_AVMemory_GetAddr(struct OH_AVMemory mem)	获取内存虚拟地址。
int32_t OH_AVMemory_GetSize(struct OH_AVMemory *mem)	获取内存长度。
OH_AVErrCode OH_AVMemory_Destroy(struct OH_AVMemory *mem)	释放OH_AVMemory实例指针的资源。

函数说明

OH_AVMemory_Create()

OH_AVMemory *OH_AVMemory_Create(int32_t size)

描述

创建OH_AVMemory实例的指针。

系统能力： SystemCapability.Multimedia.Media.Core

起始版本： 10

废弃版本： 11

替代接口： OH_AVBuffer_Create

参数：

参数项	描述
int32_t size	创建内存的大小，单位字节。

返回：

类型	说明
OH_AVMemory *	如果创建成功，返回OH_AVMemory实例的指针，如果失败，返回NULL。使用结束后需要通过OH_AVMemory_Destroy释放内存。可能的失败原因： 1. size <= 0。 2. 创建OH_AVMemory失败。 3. OH_AVMemory内存分配失败。

OH_AVMemory_GetAddr()

uint8_t *OH_AVMemory_GetAddr(struct OH_AVMemory *mem)

描述

获取内存虚拟地址。

系统能力： SystemCapability.Multimedia.Media.Core

起始版本： 9

废弃版本： 11

替代接口： OH_AVBuffer_GetAddr

参数：

参数项	描述
struct OH_AVMemory *mem	指向OH_AVMemory实例的指针。

返回：

类型	说明
uint8_t *	如果内存有效，返回内存的虚拟地址，如果内存无效，返回NULL。可能的失败原因： 1. 输入mem为空指针。 2. 输入mem参数结构校验失败。 3. 输入mem中内存为空指针。

OH_AVMemory_GetSize()

int32_t OH_AVMemory_GetSize(struct OH_AVMemory *mem)

描述

获取内存长度。

系统能力： SystemCapability.Multimedia.Media.Core

起始版本： 9

废弃版本： 11

替代接口： OH_AVBuffer_GetCapacity

参数：

参数项	描述
struct OH_AVMemory *mem	指向OH_AVMemory实例的指针。

返回：

类型	说明
int32_t	如果内存有效，返回内存长度，如果内存无效，返回-1。可能的失败原因： 1. 输入mem为空指针。 2. 输入mem参数结构校验失败。 3. 输入mem中内存为空指针。

OH_AVMemory_Destroy()

OH_AVErrCode OH_AVMemory_Destroy(struct OH_AVMemory *mem)

描述

释放OH_AVMemory实例指针的资源。

系统能力： SystemCapability.Multimedia.Media.Core

起始版本： 10

废弃版本： 11

替代接口： OH_AVBuffer_Destroy

参数：

参数项	描述
struct OH_AVMemory *mem	指向OH_AVMemory实例的指针。

返回：

类型	说明
OH_AVErrCode	AV_ERR_OK：释放成功。 AV_ERR_INVALID_VAL： 1. 输入mem为空指针。 2. 输入mem参数结构校验失败。 3. 输入mem不是开发者创建的。