harmony 鸿蒙OH_NativeBuffer

  • 2022-10-28
  • 浏览 (909)

OH_NativeBuffer

概述

提供NativeBuffer功能，通过提供的接口，可以实现共享内存的申请、使用、属性查询、释放等操作。

\@syscap SystemCapability.Graphic.Graphic2D.OH_NativeBuffer

起始版本:

9

汇总

文件

名称 描述
native_buffer.h 定义获取和使用NativeBuffer的相关函数。
引用文件： <native_buffer/native_buffer.h>
库： libnative_buffer.so

结构体

名称 描述
OH_NativeBuffer_Config OH_NativeBuffer的属性配置，用于申请新的OH_NativeBuffer实例或查询现有实例的相关属性。

类型定义

名称 描述
OH_NativeBuffer 提供OH_NativeBuffer结构体声明。

枚举

名称 描述
OH_NativeBuffer_Usage { NATIVEBUFFER_USAGE_CPU_READ = (1ULL << 0), NATIVEBUFFER_USAGE_CPU_WRITE = (1ULL << 1), NATIVEBUFFER_USAGE_MEM_DMA = (1ULL << 3) } OH_NativeBuffer的用途。
OH_NativeBuffer_Format {
NATIVEBUFFER_PIXEL_FMT_RGB_565 = 3, NATIVEBUFFER_PIXEL_FMT_RGBA_5658, NATIVEBUFFER_PIXEL_FMT_RGBX_4444, NATIVEBUFFER_PIXEL_FMT_RGBA_4444,
NATIVEBUFFER_PIXEL_FMT_RGB_444, NATIVEBUFFER_PIXEL_FMT_RGBX_5551, NATIVEBUFFER_PIXEL_FMT_RGBA_5551, NATIVEBUFFER_PIXEL_FMT_RGB_555,
NATIVEBUFFER_PIXEL_FMT_RGBX_8888, NATIVEBUFFER_PIXEL_FMT_RGBA_8888, NATIVEBUFFER_PIXEL_FMT_RGB_888, NATIVEBUFFER_PIXEL_FMT_BGR_565,
NATIVEBUFFER_PIXEL_FMT_BGRX_4444, NATIVEBUFFER_PIXEL_FMT_BGRA_4444, NATIVEBUFFER_PIXEL_FMT_BGRX_5551, NATIVEBUFFER_PIXEL_FMT_BGRA_5551,
NATIVEBUFFER_PIXEL_FMT_BGRX_8888, NATIVEBUFFER_PIXEL_FMT_BGRA_8888, NATIVEBUFFER_PIXEL_FMT_BUTT = 0X7FFFFFFF
}		 OH_NativeBuffer的格式。

函数

名称 描述
OH_NativeBuffer_Alloc (const OH_NativeBuffer_Config *config) 通过OH_NativeBuffer_Config创建OH_NativeBuffer实例，每次调用都会产生一个新的OH_NativeBuffer实例。
OH_NativeBuffer_Reference (OH_NativeBuffer *buffer) 将OH_NativeBuffer对象的引用计数加1。
OH_NativeBuffer_Unreference (OH_NativeBuffer *buffer) 将OH_NativeBuffer对象的引用计数减1，当引用计数为0的时候，该NativeBuffer对象会被析构掉。
OH_NativeBuffer_GetConfig (OH_NativeBuffer *buffer, OH_NativeBuffer_Config *config) 用于获取OH_NativeBuffer的属性。
OH_NativeBuffer_Map (OH_NativeBuffer *buffer, void **virAddr) 将OH_NativeBuffer对应的ION内存映射到进程空间。
OH_NativeBuffer_Unmap (OH_NativeBuffer *buffer) 将OH_NativeBuffer对应的ION内存从进程空间移除。
OH_NativeBuffer_GetSeqNum (OH_NativeBuffer *buffer) 获取OH_NativeBuffer的序列号。

类型定义说明

OH_NativeBuffer

typedef struct OH_NativeBuffer OH_NativeBuffer

描述:

提供OH_NativeBuffer结构体声明。

枚举类型说明

OH_NativeBuffer_Format

enum OH_NativeBuffer_Format

描述:

OH_NativeBuffer的格式。

\@SysCap SystemCapability.Graphic.Graphic2D.NativeBuffer

枚举值 描述
NATIVEBUFFER_PIXEL_FMT_RGB_565 RGB565格式
NATIVEBUFFER_PIXEL_FMT_RGBA_5658 RGBA5658格式
NATIVEBUFFER_PIXEL_FMT_RGBX_4444 RGBX4444格式
NATIVEBUFFER_PIXEL_FMT_RGBA_4444 RGBA4444格式
NATIVEBUFFER_PIXEL_FMT_RGB_444 RGB444格式
NATIVEBUFFER_PIXEL_FMT_RGBX_5551 RGBX5551格式
NATIVEBUFFER_PIXEL_FMT_RGBA_5551 RGBA5551格式
NATIVEBUFFER_PIXEL_FMT_RGB_555 RGB555格式
NATIVEBUFFER_PIXEL_FMT_RGBX_8888 RGBX8888格式
NATIVEBUFFER_PIXEL_FMT_RGBA_8888 RGBA8888格式
NATIVEBUFFER_PIXEL_FMT_RGB_888 RGB888格式
NATIVEBUFFER_PIXEL_FMT_BGR_565 BGR565格式
NATIVEBUFFER_PIXEL_FMT_BGRX_4444 BGRX4444格式
NATIVEBUFFER_PIXEL_FMT_BGRA_4444 BGRA4444格式
NATIVEBUFFER_PIXEL_FMT_BGRX_5551 BGRX5551格式
NATIVEBUFFER_PIXEL_FMT_BGRA_5551 BGRA5551格式
NATIVEBUFFER_PIXEL_FMT_BGRX_8888 BGRX8888格式
NATIVEBUFFER_PIXEL_FMT_BGRA_8888 BGRA8888格式
NATIVEBUFFER_PIXEL_FMT_BUTT 无效格式

起始版本：

10

OH_NativeBuffer_Usage

enum OH_NativeBuffer_Usage

描述:

OH_NativeBuffer的用途。

\@SysCap SystemCapability.Graphic.Graphic2D.NativeBuffer

枚举值 描述
NATIVEBUFFER_USAGE_CPU_READ CPU可读
NATIVEBUFFER_USAGE_CPU_WRITE CPU可写
NATIVEBUFFER_USAGE_MEM_DMA 直接内存访问缓冲区

起始版本：

10

函数说明

OH_NativeBuffer_Alloc()

OH_NativeBuffer* OH_NativeBuffer_Alloc (const OH_NativeBuffer_Config * config)

描述:

通过OH_NativeBuffer_Config创建OH_NativeBuffer实例，每次调用都会产生一个新的OH_NativeBuffer实例。

\@syscap SystemCapability.Graphic.Graphic2D.OH_NativeBuffer

参数:

名称 描述
config 一个指向OH_NativeBuffer_Config类型的指针。

返回:

创建成功则返回一个指向OH_NativeBuffer结构体实例的指针，否则返回NULL。

OH_NativeBuffer_GetConfig()

void OH_NativeBuffer_GetConfig (OH_NativeBuffer * buffer, OH_NativeBuffer_Config * config )

描述:

用于获取OH_NativeBuffer的属性。

\@syscap SystemCapability.Graphic.Graphic2D.OH_NativeBuffer

参数:

名称 描述
buffer 一个指向OH_NativeBuffer实例的指针。
config 一个指向OH_NativeBuffer_Config的指针，用于接收OH_NativeBuffer的属性。

OH_NativeBuffer_GetSeqNum()

uint32_t OH_NativeBuffer_GetSeqNum (OH_NativeBuffer * buffer)

描述:

获取OH_NativeBuffer的序列号。

\@syscap SystemCapability.Graphic.Graphic2D.OH_NativeBuffer

参数:

名称 描述
buffer 一个指向OH_NativeBuffer实例的指针。

返回:

返回对应OH_NativeBuffer的唯一序列号。

OH_NativeBuffer_Map()

int32_t OH_NativeBuffer_Map (OH_NativeBuffer * buffer, void ** virAddr )

描述:

将OH_NativeBuffer对应的ION内存映射到进程空间。

\@syscap SystemCapability.Graphic.Graphic2D.OH_NativeBuffer

参数:

名称 描述
buffer 一个指向OH_NativeBuffer实例的指针。
virAddr 一个二级指针，二级指针指向映射到当前进程的虚拟内存的地址。

返回:

返回值为0表示执行成功。

OH_NativeBuffer_Reference()

int32_t OH_NativeBuffer_Reference (OH_NativeBuffer * buffer)

描述:

将OH_NativeBuffer对象的引用计数加1。

\@syscap SystemCapability.Graphic.Graphic2D.OH_NativeBuffer

参数:

名称 描述
buffer 一个指向OH_NativeBuffer实例的指针。

返回:

返回值为0表示执行成功。

OH_NativeBuffer_Unmap()

int32_t OH_NativeBuffer_Unmap (OH_NativeBuffer * buffer)

描述:

将OH_NativeBuffer对应的ION内存从进程空间移除。

\@syscap SystemCapability.Graphic.Graphic2D.OH_NativeBuffer

参数:

名称 描述
buffer 一个指向OH_NativeBuffer实例的指针。

返回:

返回值为0表示执行成功。

OH_NativeBuffer_Unreference()

int32_t OH_NativeBuffer_Unreference (OH_NativeBuffer * buffer)

描述:

将OH_NativeBuffer对象的引用计数减1，当引用计数为0的时候，该NativeBuffer对象会被析构掉。

\@syscap SystemCapability.Graphic.Graphic2D.OH_NativeBuffer

参数:

名称 描述
buffer 一个指向OH_NativeBuffer实例的指针。

返回:

返回值为0表示执行成功。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Native API

harmony 鸿蒙AVCapability

harmony 鸿蒙AVDemuxer

harmony 鸿蒙AVMuxer

harmony 鸿蒙AVScreenCapture

harmony 鸿蒙AVSource

harmony 鸿蒙AudioDecoder

harmony 鸿蒙AudioEncoder

harmony 鸿蒙CodecBase

harmony 鸿蒙Core

0  赞
  • 所属分类： 后端技术
  • 本文标签：
  • 版权声明： 原创文章如转载，请注明本文链接: https://www.seaxiang.com/blog/b6a3e2d3415649f18e94bddeef48ce97
热门推荐
标签云
Linux Java Spring Spring Boot docker 大数据 前端 生活 maven golang 软件 spring cloud fintech mac vscode 其他 区块链 以太坊 V神 开发者 技术 股票 git greenplum 分布式事务 chrome mysql flink kafka 设计模式 原理 鸿蒙 seo
最新文章
本文目录