harmony 鸿蒙external_window.h

  • 2025-06-12
  • 浏览 (3)

external_window.h

概述

定义获取和使用NativeWindow的相关函数。

相关示例： NDKNativeWindow

引用文件：

库： libnative_window.so

起始版本： 8

相关模块： NativeWindow

汇总

结构体

|名称|typedef关键字|描述| |–|–|–| |Region|Region|表示本地窗口OHNativeWindow需要更新内容的矩形区域（脏区）。| |Rect|-|如果rects是空指针nullptr，默认Buffer大小为脏区。| |OHHDRMetaData|OHHDRMetaData|HDR元数据结构体定义。| |OHExtDataHandle|OHExtDataHandle|扩展数据句柄结构体定义。| |OHIPCParcel|OHIPCParcel|提供对IPC序列化对象的访问功能。| |NativeWindow|OHNativeWindow|提供对OHNativeWindow的访问功能。| |NativeWindowBuffer|OHNativeWindowBuffer|提供对OHNativeWindowBuffer的访问功能。|

枚举

|名称|typedef关键字|描述| |–|–|–| |NativeWindowOperation|NativeWindowOperation|OH_NativeWindow_NativeWindowHandleOpt函数中的操作码。| |OHScalingMode|OHScalingMode|缩放模式Scaling Mode。| |OHScalingModeV2|OHScalingModeV2|渲染缩放模式枚举。| |OHHDRMetadataKey|OHHDRMetadataKey|枚举HDR元数据关键字。| |OHSurfaceSource|OHSurfaceSource|本地窗口内容来源类型枚举。|

函数

|名称|描述| |–|–| |OHNativeWindow* OH_NativeWindow_CreateNativeWindow(void* pSurface)|创建OHNativeWindow实例，每次调用都会产生一个新的OHNativeWindow实例。
说明：此接口不可用，可通过OH_NativeImage_AcquireNativeWindow创建，或通过XComponent创建。| |void OH_NativeWindow_DestroyNativeWindow(OHNativeWindow* window)|将OHNativeWindow对象的引用计数减1，当引用计数为0的时候，该OHNativeWindow对象会被析构掉。
本接口为非线程安全类型接口。| |OHNativeWindowBuffer* OH_NativeWindow_CreateNativeWindowBufferFromSurfaceBuffer(void* pSurfaceBuffer)|创建OHNativeWindowBuffer实例，每次调用都会产生一个新的OHNativeWindowBuffer实例。
说明：此接口不可用，使用OH_NativeWindow_CreateNativeWindowBufferFromNativeBuffer替代。| |OHNativeWindowBuffer* OH_NativeWindow_CreateNativeWindowBufferFromNativeBuffer(OH_NativeBuffer* nativeBuffer)|创建OHNativeWindowBuffer实例，每次调用都会产生一个新的OHNativeWindowBuffer实例。
本接口需要与OH_NativeWindow_DestroyNativeWindowBuffer接口配合使用，否则会存在内存泄露。
本接口为非线程安全类型接口。| |void OH_NativeWindow_DestroyNativeWindowBuffer(OHNativeWindowBuffer* buffer)|将OHNativeWindowBuffer对象的引用计数减1，当引用计数为0的时候，该OHNativeWindowBuffer对象会被析构掉。
本接口为非线程安全类型接口。| |int32_t OH_NativeWindow_NativeWindowRequestBuffer(OHNativeWindow *window,OHNativeWindowBuffer **buffer, int *fenceFd)|通过OHNativeWindow对象申请一块OHNativeWindowBuffer，用以内容生产。
在调用本接口前，需要通过SET_BUFFER_GEOMETRY对OHNativeWindow设置宽高。
本接口需要与OH_NativeWindow_NativeWindowFlushBuffer接口配合使用，否则内存会耗尽。
当fenceFd使用完，用户需要将其close。
本接口为非线程安全类型接口。| |int32_t OH_NativeWindow_NativeWindowFlushBuffer(OHNativeWindow *window, OHNativeWindowBuffer *buffer,int fenceFd, Region region)|通过OHNativeWindow将生产好内容的OHNativeWindowBuffer放回到Buffer队列中，用以内容消费。
系统会将fenceFd关闭，无需用户close。
本接口为非线程安全类型接口。| |int32_t OH_NativeWindow_GetLastFlushedBuffer(OHNativeWindow *window, OHNativeWindowBuffer **buffer,int *fenceFd, float matrix[16])|从OHNativeWindow获取上次送回到buffer队列中的OHNativeWindowBuffer。| |int32_t OH_NativeWindow_NativeWindowAbortBuffer(OHNativeWindow *window, OHNativeWindowBuffer *buffer)|通过OHNativeWindow将之前申请出来的OHNativeWindowBuffer返还到Buffer队列中，供下次再申请。
本接口为非线程安全类型接口。| |int32_t OH_NativeWindow_NativeWindowHandleOpt(OHNativeWindow *window, int code, …)|设置/获取OHNativeWindow的属性，包括设置/获取宽高、内容格式等。
本接口为非线程安全类型接口。| |BufferHandle *OH_NativeWindow_GetBufferHandleFromNative(OHNativeWindowBuffer *buffer)|通过OHNativeWindowBuffer获取该buffer的BufferHandle指针。
本接口为非线程安全类型接口。| |int32_t OH_NativeWindow_NativeObjectReference(void *obj)|增加一个NativeObject的引用计数。
本接口需要与OH_NativeWindow_NativeObjectUnreference接口配合使用，否则会存在内存泄露。
本接口为非线程安全类型接口。| |int32_t OH_NativeWindow_NativeObjectUnreference(void *obj)|减少一个NativeObject的引用计数，当引用计数减少为0时，该NativeObject将被析构掉。
本接口为非线程安全类型接口。| |int32_t OH_NativeWindow_GetNativeObjectMagic(void *obj)|获取NativeObject的MagicId。
本接口为非线程安全类型接口。| |int32_t OH_NativeWindow_NativeWindowSetScalingMode(OHNativeWindow *window, uint32_t sequence,OHScalingMode scalingMode)|设置OHNativeWindow的ScalingMode。| |int32_t OH_NativeWindow_NativeWindowSetMetaData(OHNativeWindow *window, uint32_t sequence, int32_t size,const OHHDRMetaData *metaData)|设置OHNativeWindow的元数据。| |int32_t OH_NativeWindow_NativeWindowSetMetaDataSet(OHNativeWindow *window, uint32_t sequence, OHHDRMetadataKey key,int32_t size, const uint8_t *metaData)|设置OHNativeWindow的元数据集。| |int32_t OH_NativeWindow_NativeWindowSetTunnelHandle(OHNativeWindow *window, const OHExtDataHandle *handle)|设置OHNativeWindow的TunnelHandle。| |int32_t OH_NativeWindow_NativeWindowAttachBuffer(OHNativeWindow *window, OHNativeWindowBuffer *buffer)|将OHNativeWindowBuffer添加进OHNativeWindow中。
本接口需要与OH_NativeWindow_NativeWindowDetachBuffer接口配合使用，否则会存在内存管理混乱问题。
本接口为非线程安全类型接口。
| |int32_t OH_NativeWindow_NativeWindowDetachBuffer(OHNativeWindow *window, OHNativeWindowBuffer *buffer)|将OHNativeWindowBuffer从OHNativeWindow中分离。
本接口为非线程安全类型接口。| |int32_t OH_NativeWindow_GetSurfaceId(OHNativeWindow *window, uint64_t *surfaceId)|通过OHNativeWindow获取对应的surfaceId。
本接口为非线程安全类型接口。| |int32_t OH_NativeWindow_CreateNativeWindowFromSurfaceId(uint64_t surfaceId, OHNativeWindow **window)|通过surfaceId创建对应的OHNativeWindow。
本接口需要与OH_NativeWindow_DestroyNativeWindow接口配合使用，否则会存在内存泄露。
如果存在并发释放OHNativeWindow的情况，需要通过OH_NativeWindow_NativeObjectReference和OH_NativeWindow_NativeObjectUnreference对OHNativeWindow进行引用计数加一和减一。
通过surfaceId获取的surface需要是在本进程中创建的，不能跨进程获取surface。
本接口为非线程安全类型接口。| |int32_t OH_NativeWindow_NativeWindowSetScalingModeV2(OHNativeWindow* window, OHScalingModeV2 scalingMode)|设置OHNativeWindow的渲染缩放模式。
本接口为非线程安全类型接口。| |int32_t OH_NativeWindow_GetLastFlushedBufferV2(OHNativeWindow *window, OHNativeWindowBuffer **buffer,int *fenceFd, float matrix[16])|从OHNativeWindow获取上次送回到buffer队列中的OHNativeWindowBuffer,与OH_NativeWindow_GetLastFlushedBuffer的差异在于matrix不同。
本接口需要与OH_NativeWindow_NativeObjectUnreference接口配合使用，否则会存在内存泄露。
本接口为非线程安全类型接口。| |void OH_NativeWindow_SetBufferHold(OHNativeWindow *window)|提前缓存一帧buffer，且缓存的这一帧延迟一帧上屏显示，以此抵消后续一次超长帧丢帧。
本接口为非线程安全类型接口。| |int32_t OH_NativeWindow_WriteToParcel(OHNativeWindow *window, OHIPCParcel *parcel)|将窗口对象写入IPC序列化对象中。
本接口为非线程安全类型接口。| |int32_t OH_NativeWindow_ReadFromParcel(OHIPCParcel *parcel, OHNativeWindow **window)|从IPC序列化对象中读取窗口对象。
本接口为非线程安全类型接口。| |int32_t OH_NativeWindow_SetColorSpace(OHNativeWindow *window, OH_NativeBuffer_ColorSpace colorSpace)|为OHNativeWindow设置颜色空间属性。
本接口为非线程安全类型接口。| |int32_t OH_NativeWindow_GetColorSpace(OHNativeWindow *window, OH_NativeBuffer_ColorSpace *colorSpace)|获取OHNativeWindow颜色空间属性。
本接口为非线程安全类型接口。| |int32_t OH_NativeWindow_SetMetadataValue(OHNativeWindow *window, OH_NativeBuffer_MetadataKey metadataKey,int32_t size, uint8_t *metadata)|为OHNativeWindow设置元数据属性值。
本接口为非线程安全类型接口。| |int32_t OH_NativeWindow_GetMetadataValue(OHNativeWindow *window, OH_NativeBuffer_MetadataKey metadataKey,int32_t *size, uint8_t **metadata)|获取OHNativeWindow元数据属性值。
本接口为非线程安全类型接口。| |int32_t OH_NativeWindow_CleanCache(OHNativeWindow *window)|清理OHNativeWindow中的OHNativeWindowBuffer缓存。
使用该接口清理缓存前，需确保已通过OH_NativeWindow_NativeWindowRequestBuffer接口成功申请OHNativeWindowBuffer。
本接口为非线程安全类型接口。|

枚举类型说明

NativeWindowOperation

enum NativeWindowOperation

描述

OH_NativeWindow_NativeWindowHandleOpt函数中的操作码。

起始版本： 8

|枚举项|描述| |–|–| |SET_BUFFER_GEOMETRY|设置本地窗口缓冲区几何图形，函数中的可变参数是[输入] int32_t width，[输入] int32_t height。| |GET_BUFFER_GEOMETRY|获取本地窗口缓冲区几何图形，函数中的可变参数是[输出] int32_theight，[输入] int32_twidth。| |GET_FORMAT|获取本地窗口缓冲区格式，函数中的可变参数是[输出] int32_tformat，取值具体可见OH_NativeBuffer_Format枚举值。| |SET_FORMAT|设置本地窗口缓冲区格式，函数中的可变参数是[输入] int32_t format，取值具体可见OH_NativeBuffer_Format枚举值。| |GET_USAGE|获取本地窗口读写方式，函数中的可变参数是[输出] uint64_tusage，取值具体可见OH_NativeBuffer_Usage枚举值。| |SET_USAGE|设置本地窗口缓冲区读写方式，函数中的可变参数是[输入] uint64_t usage，取值具体可见OH_NativeBuffer_Usage枚举值。| |SET_STRIDE|设置本地窗口缓冲区步幅，函数中的可变参数是[输入] int32_t stride。
废弃版本： 16| |GET_STRIDE|获取本地窗口缓冲区步幅，函数中的可变参数是[输出] int32_t *stride。
废弃版本： 16
替代方案： 使用OH_NativeWindow_GetBufferHandleFromNative接口获取BufferHandle实例，从BufferHandle实例中获取stride值。| |SET_SWAP_INTERVAL|设置本地窗口缓冲区交换间隔，函数中的可变参数是[输入] int32_t interval。| |GET_SWAP_INTERVAL|获取本地窗口缓冲区交换间隔，函数中的可变参数是[输出] int32_tinterval。| |SET_TIMEOUT|设置请求本地窗口请求缓冲区的超时等待时间，未手动设置时默认值为3000毫秒，函数中的可变参数是[输入] int32_t timeout, 单位为毫秒。| |GET_TIMEOUT|获取请求本地窗口请求缓冲区的超时等待时间，未手动设置时默认值为3000毫秒，函数中的可变参数是[输出] int32_ttimeout，单位为毫秒。| |SET_COLOR_GAMUT|设置本地窗口缓冲区色彩空间，函数中的可变参数是[输入] int32_t colorGamut，取值具体可见OH_NativeBuffer_ColorGamut枚举值。| |GET_COLOR_GAMUT|获取本地窗口缓冲区色彩空间，函数中的可变参数是[输出] int32_tcolorGamut，取值具体可见OH_NativeBuffer_ColorGamut枚举值。| |SET_TRANSFORM|设置本地窗口缓冲区变换，函数中的可变参数是[输入] int32_t transform，取值具体可见OH_NativeBuffer_TransformType枚举值。| |GET_TRANSFORM|获取本地窗口缓冲区变换，函数中的可变参数是[输出] int32_ttransform，取值具体可见OH_NativeBuffer_TransformType枚举值。| |SET_UI_TIMESTAMP|设置本地窗口缓冲区UI时间戳，函数中的可变参数是[输入] uint64_t uiTimestamp。| |GET_BUFFERQUEUE_SIZE|获取内存队列大小，函数中的可变参数是[输出] int32_t *size。
起始版本： 12| |SET_SOURCE_TYPE|设置本地窗口内容来源，函数中的可变参数是[输入] int32_t sourceType，取值具体可见OHSurfaceSource枚举值。
起始版本： 12| |GET_SOURCE_TYPE|获取本地窗口内容来源，函数中的可变参数是[输出] int32_t *sourceType，取值具体可见OHSurfaceSource枚举值。
起始版本： 12| |SET_APP_FRAMEWORK_TYPE|设置本地窗口应用框架名称，函数中的可变参数是[输入] char* frameworkType，最大支持64字节。
起始版本： 12| |GET_APP_FRAMEWORK_TYPE|获取本地窗口应用框架名称，函数中的可变参数是[输出] char* frameworkType。
起始版本： 12| |SET_HDR_WHITE_POINT_BRIGHTNESS|设置HDR白点亮度，函数中的可变参数是[输入] float brightness。取值范围为[0.0f, 1.0f]。
起始版本： 12| |SET_SDR_WHITE_POINT_BRIGHTNESS|设置SDR白点亮度，函数中的可变参数是[输入] float brightness。取值范围为[0.0f, 1.0f]。
起始版本： 12| |SET_DESIRED_PRESENT_TIMESTAMP = 24|设置本地窗口缓冲区期望上屏时间的时间戳。
当且仅当RenderService为本地窗口的消费者时，该时间戳生效
本操作执行后需要配合调用OH_NativeWindow_NativeWindowFlushBuffer生效。
生产者下一次放入队列的buffer，达到该期望上屏时间后，才会被RenderService消费并上屏。
如果buffer队列中存在多个生产者放入的buffer，都设置了desiredPresentTimestamp并已达到期望上屏时间，则较早入队的buffer将被消费者丢弃回队列。
如果期望上屏时间大于消费者提供的时间 1 秒以上，则该期望上屏时间戳将被忽略。
函数中的可变参数是[输入] int64_t desiredPresentTimestamp，取值范围大于0，应由std::chrono::steady_clock标准库时钟生成，且单位为纳秒。
起始版本： 13|

OHScalingMode

enum OHScalingMode

描述

缩放模式Scaling Mode。

起始版本： 9

废弃版本： 10

替代接口： OHScalingModeV2

|枚举项|描述| |–|–| |OH_SCALING_MODE_FREEZE = 0|在接收到窗口大小的缓冲区之前，不可以更新窗口内容。| |OH_SCALING_MODE_SCALE_TO_WINDOW|缓冲区在二维中缩放以匹配窗口大小。| |OH_SCALING_MODE_SCALE_CROP|缓冲区被统一缩放，使得缓冲区的较小尺寸与窗口大小匹配。| |OH_SCALING_MODE_NO_SCALE_CROP|窗口被裁剪为缓冲区裁剪矩形的大小，裁剪矩形之外的像素被视为完全透明。|

OHScalingModeV2

enum OHScalingModeV2

描述

渲染缩放模式枚举。

起始版本： 12

|枚举项|描述| |–|–| |OH_SCALING_MODE_FREEZE_V2 = 0|冻结窗口，在接收到和窗口大小相等的缓冲区之前，窗口内容不进行更新。| |OH_SCALING_MODE_SCALE_TO_WINDOW_V2|缓冲区进行拉伸缩放以匹配窗口大小。| |OH_SCALING_MODE_SCALE_CROP_V2|缓冲区按原比例缩放，使得缓冲区的较小边与窗口匹配，较长边超出窗口部分被视为透明。| |OH_SCALING_MODE_NO_SCALE_CROP_V2|按窗口大小将缓冲区裁剪，裁剪矩形之外的像素被视为完全透明。| |OH_SCALING_MODE_SCALE_FIT_V2|缓冲区按原比例缩放。优先显示所有缓冲区内容。如果比例与窗口比例不同，用背景颜色填充窗口的未填充区域。
开发板和模拟器不支持该模式。|

OHHDRMetadataKey

enum OHHDRMetadataKey

描述

枚举HDR元数据关键字。

起始版本： 9

废弃版本： 10

|枚举项|描述| |–|–| |OH_METAKEY_RED_PRIMARY_X = 0|红基色X坐标。| |OH_METAKEY_RED_PRIMARY_Y = 1,|红基色Y坐标。| |OH_METAKEY_GREEN_PRIMARY_X = 2,|绿基色X坐标。| |OH_METAKEY_GREEN_PRIMARY_Y = 3,|绿基色Y坐标。| |OH_METAKEY_BLUE_PRIMARY_X = 4,|蓝基色X坐标。| |OH_METAKEY_BLUE_PRIMARY_Y = 5,|蓝基色Y坐标。| |OH_METAKEY_WHITE_PRIMARY_X = 6,|白点X坐标。| |OH_METAKEY_WHITE_PRIMARY_Y = 7,|白点Y坐标。| |OH_METAKEY_MAX_LUMINANCE = 8,|最大的光亮度。| |OH_METAKEY_MIN_LUMINANCE = 9,|最小的光亮度。| |OH_METAKEY_MAX_CONTENT_LIGHT_LEVEL = 10,|最大的内容亮度水平。| |OH_METAKEY_MAX_FRAME_AVERAGE_LIGHT_LEVEL = 11,|最大的帧平均亮度水平。| |OH_METAKEY_HDR10_PLUS = 12,|HDR10 Plus。| |OH_METAKEY_HDR_VIVID = 13,|Vivid。|

OHSurfaceSource

enum OHSurfaceSource

描述

本地窗口内容来源类型枚举。

起始版本： 12

|枚举项|描述| |–|–| |OH_SURFACE_SOURCE_DEFAULT = 0|窗口内容默认来源。| |OH_SURFACE_SOURCE_UI|窗口内容来自于UI。| |OH_SURFACE_SOURCE_GAME|窗口内容来自于游戏。| |OH_SURFACE_SOURCE_CAMERA|窗口内容来自于相机。| |OH_SURFACE_SOURCE_VIDEO|窗口内容来自于视频。|

函数说明

OH_NativeWindow_CreateNativeWindow()

OHNativeWindow* OH_NativeWindow_CreateNativeWindow(void* pSurface)

描述

创建OHNativeWindow实例，每次调用都会产生一个新的OHNativeWindow实例。
说明：此接口不可用，可通过OH_NativeImage_AcquireNativeWindow创建，或通过XComponent创建。

系统能力： SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本： 8

废弃版本： 从API version 12开始废弃，不再提供替代接口。

参数：

|参数项|描述| |–|–| |void* pSurface|一个指向生产者ProduceSurface的指针，类型为sptr<OHOS::Surface>。|

返回：

|类型|说明| |–|–| |OHNativeWindow*|返回一个指针，指向OHNativeWindow的结构体实例。|

OH_NativeWindow_DestroyNativeWindow()

void OH_NativeWindow_DestroyNativeWindow(OHNativeWindow* window)

描述

将OHNativeWindow对象的引用计数减1，当引用计数为0的时候，该OHNativeWindow对象会被析构掉。
本接口为非线程安全类型接口。

系统能力： SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本： 8

参数：

|参数项|描述| |–|–| |OHNativeWindow* window|一个OHNativeWindow的结构体实例的指针。|

OH_NativeWindow_CreateNativeWindowBufferFromSurfaceBuffer()

OHNativeWindowBuffer* OH_NativeWindow_CreateNativeWindowBufferFromSurfaceBuffer(void* pSurfaceBuffer)

描述

创建OHNativeWindowBuffer实例，每次调用都会产生一个新的OHNativeWindowBuffer实例。
说明：此接口不可用，使用OH_NativeWindow_CreateNativeWindowBufferFromNativeBuffer替代。

系统能力： SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本： 8

废弃版本： 12

替代接口： OH_NativeWindow_CreateNativeWindowBufferFromNativeBuffer

参数：

|参数项|描述| |–|–| |void* pSurfaceBuffer|一个指向生产者buffer的指针，类型为sptrOHOS::SurfaceBuffer。|

返回：

|类型|说明| |–|–| |OHNativeWindowBuffer*|返回一个指针，指向OHNativeWindowBuffer的结构体实例。|

OH_NativeWindow_CreateNativeWindowBufferFromNativeBuffer()

OHNativeWindowBuffer* OH_NativeWindow_CreateNativeWindowBufferFromNativeBuffer(OH_NativeBuffer* nativeBuffer)

描述

创建OHNativeWindowBuffer实例，每次调用都会产生一个新的OHNativeWindowBuffer实例。
本接口需要与OH_NativeWindow_DestroyNativeWindowBuffer接口配合使用，否则会存在内存泄露。
本接口为非线程安全类型接口。

系统能力： SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本： 11

参数：

|参数项|描述| |–|–| |OH_NativeBuffer* nativeBuffer|一个指向OH_NativeBuffer的指针。|

返回：

|类型|说明| |–|–| |OHNativeWindowBuffer*|返回一个指针，指向OHNativeWindowBuffer的结构体实例。|

OH_NativeWindow_DestroyNativeWindowBuffer()

void OH_NativeWindow_DestroyNativeWindowBuffer(OHNativeWindowBuffer* buffer)

描述

将OHNativeWindowBuffer对象的引用计数减1，当引用计数为0的时候，该OHNativeWindowBuffer对象会被析构掉。
本接口为非线程安全类型接口。

系统能力： SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本： 8

参数：

|参数项|描述| |–|–| |OHNativeWindowBuffer* buffer|一个OHNativeWindowBuffer的结构体实例的指针。|

OH_NativeWindow_NativeWindowRequestBuffer()

int32_t OH_NativeWindow_NativeWindowRequestBuffer(OHNativeWindow *window,OHNativeWindowBuffer **buffer, int *fenceFd)

描述

通过OHNativeWindow对象申请一块OHNativeWindowBuffer，用以内容生产。
在调用本接口前，需要通过SET_BUFFER_GEOMETRY对OHNativeWindow设置宽高。
本接口需要与OH_NativeWindow_NativeWindowFlushBuffer接口配合使用，否则内存会耗尽。
当fenceFd使用完，用户需要将其close。
本接口为非线程安全类型接口。

系统能力： SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本： 8

参数：

|参数项|描述| |–|–| |OHNativeWindow *window|一个OHNativeWindow的结构体实例的指针。| |OHNativeWindowBuffer **buffer|一个指向OHNativeWindowBuffer指针的指针（二级指针）。
通过OH_NativeWindow_GetBufferHandleFromNative可获取BufferHandle结构体，访问缓冲区内存。| |int *fenceFd|一个文件描述符句柄，用于GPU/CPU同步：不同取值及含义如下：
- 返回≥0：缓冲区正被GPU使用，需要等待文件描述符fenceFd就绪。
- 返回-1：缓冲区可直接使用。|

返回：

|类型|说明| |–|–| |int32_t|返回值为0表示执行成功，其他返回值可参考OHNativeErrorCode。|

OH_NativeWindow_NativeWindowFlushBuffer()

int32_t OH_NativeWindow_NativeWindowFlushBuffer(OHNativeWindow *window, OHNativeWindowBuffer *buffer,int fenceFd, Region region)

描述

通过OHNativeWindow将生产好内容的OHNativeWindowBuffer放回到Buffer队列中，用以内容消费。
系统会将fenceFd关闭，无需用户close。
本接口为非线程安全类型接口。

系统能力： SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本： 8

参数：

|参数项|描述| |–|–| |OHNativeWindow *window|一个OHNativeWindow的结构体实例的指针。| |OHNativeWindowBuffer *buffer|一个OHNativeWindowBuffer的结构体实例的指针。| |int fenceFd|一个文件描述符句柄，用以同步时序。不同取值及含义如下：
- -1：CPU渲染完成，无需同步时序。
- ≥0：从GPU同步对象转换（如EGL的eglDupNativeFenceFDANDROID），对端需要通过此fenceFd同步时序。| |Region region|一个Region结构体，表示一块脏区域，该区域有内容更新。|

返回：

|类型|说明| |–|–| |int32_t|返回值为0表示执行成功，其他返回值可参考OHNativeErrorCode。|

OH_NativeWindow_GetLastFlushedBuffer()

int32_t OH_NativeWindow_GetLastFlushedBuffer(OHNativeWindow *window, OHNativeWindowBuffer **buffer,int *fenceFd, float matrix[16])

描述

从OHNativeWindow获取上次送回到buffer队列中的OHNativeWindowBuffer。

系统能力： SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本： 11

废弃版本： 从API version 12开始废弃。

替代接口： OH_NativeWindow_GetLastFlushedBufferV2

参数：

|参数项|描述| |–|–| |OHNativeWindow *window|一个OHNativeWindow的结构体实例的指针。| |OHNativeWindowBuffer **buffer|一个OHNativeWindowBuffer结构体指针的指针。| |int *fenceFd|一个文件描述符的指针。| |matrix| 表示检索到的44变换矩阵。|

返回：

|类型|说明| |–|–| |int32_t|返回值为0表示执行成功，其他返回值可参考OHNativeErrorCode。|

OH_NativeWindow_NativeWindowAbortBuffer()

int32_t OH_NativeWindow_NativeWindowAbortBuffer(OHNativeWindow *window, OHNativeWindowBuffer *buffer)

描述

通过OHNativeWindow将之前申请出来的OHNativeWindowBuffer返还到Buffer队列中，供下次再申请。
本接口为非线程安全类型接口。

系统能力： SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本： 8

参数：

|参数项|描述| |–|–| |OHNativeWindow *window|一个OHNativeWindow的结构体实例的指针。| |OHNativeWindowBuffer *buffer|一个OHNativeWindowBuffer的结构体实例的指针。|

返回：

|类型|说明| |–|–| |int32_t|返回值为0表示执行成功，其他返回值可参考OHNativeErrorCode。|

OH_NativeWindow_NativeWindowHandleOpt()

int32_t OH_NativeWindow_NativeWindowHandleOpt(OHNativeWindow *window, int code, ...)

描述

设置/获取OHNativeWindow的属性，包括设置/获取宽高、内容格式等。
本接口为非线程安全类型接口。

系统能力： SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本： 8

参数：

|参数项|描述| |–|–| |OHNativeWindow *window|一个OHNativeWindow的结构体实例的指针。| |int code|表示操作码，详见NativeWindowOperation。| |…| 可变参数，必须与操作码对应的数据类型保持一致，且入参数量严格按照操作码提示传入，否则会存在未定义行为。|

返回：

|类型|说明| |–|–| |int32_t|返回值为0表示执行成功，其他返回值可参考OHNativeErrorCode。|

OH_NativeWindow_GetBufferHandleFromNative()

BufferHandle *OH_NativeWindow_GetBufferHandleFromNative(OHNativeWindowBuffer *buffer)

描述

通过OHNativeWindowBuffer获取该buffer的BufferHandle指针。
本接口为非线程安全类型接口。

系统能力： SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本： 8

参数：

|参数项|描述| |–|–| |OHNativeWindowBuffer *buffer|一个OHNativeWindowBuffer的结构体实例的指针。|

返回：

|类型|说明| |–|–| |BufferHandle|BufferHandle 返回一个指针，指向BufferHandle的结构体实例。|

OH_NativeWindow_NativeObjectReference()

int32_t OH_NativeWindow_NativeObjectReference(void *obj)

描述

增加一个NativeObject的引用计数。
本接口需要与OH_NativeWindow_NativeObjectUnreference接口配合使用，否则会存在内存泄露。
本接口为非线程安全类型接口。

系统能力： SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本： 8

参数：

|参数项|描述| |–|–| |void *obj|一个OHNativeWindow或者OHNativeWindowBuffer的结构体实例的指针。|

返回：

|类型|说明| |–|–| |int32_t|返回值为0表示执行成功，其他返回值可参考OHNativeErrorCode。|

OH_NativeWindow_NativeObjectUnreference()

int32_t OH_NativeWindow_NativeObjectUnreference(void *obj)

描述

减少一个NativeObject的引用计数，当引用计数减少为0时，该NativeObject将被析构掉。
本接口为非线程安全类型接口。

系统能力： SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本： 8

参数：

|参数项|描述| |–|–| |void *obj|一个OHNativeWindow或者OHNativeWindowBuffer的结构体实例的指针。|

返回：

|类型|说明| |–|–| |int32_t|返回值为0表示执行成功，其他返回值可参考OHNativeErrorCode。|

OH_NativeWindow_GetNativeObjectMagic()

int32_t OH_NativeWindow_GetNativeObjectMagic(void *obj)

描述

获取NativeObject的MagicId。
本接口为非线程安全类型接口。

系统能力： SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本： 8

参数：

|参数项|描述| |–|–| |void *obj|一个OHNativeWindow或者OHNativeWindowBuffer的结构体实例的指针。|

返回：

|类型|说明| |–|–| |int32_t|MagicId 返回值为魔鬼数字，每个NativeObject唯一。|

OH_NativeWindow_NativeWindowSetScalingMode()

int32_t OH_NativeWindow_NativeWindowSetScalingMode(OHNativeWindow *window, uint32_t sequence,OHScalingMode scalingMode)

描述

设置OHNativeWindow的ScalingMode。

系统能力： SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本： 9

废弃版本： 从API version 10开始废弃。

替代接口： OH_NativeWindow_NativeWindowSetScalingModeV2

参数：

|参数项|描述| |–|–| |OHNativeWindow *window|一个OHNativeWindow的结构体实例的指针。| |uint32_t sequence|生产缓冲区的序列。| |OHScalingMode scalingMode|枚举值OHScalingMode。|

返回：

|类型|说明| |–|–| |int32_t|返回值为0表示执行成功。|

OH_NativeWindow_NativeWindowSetMetaData()

int32_t OH_NativeWindow_NativeWindowSetMetaData(OHNativeWindow *window, uint32_t sequence, int32_t size,const OHHDRMetaData *metaData)

描述

设置OHNativeWindow的元数据。

系统能力： SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本： 9

废弃版本： 从API version 10开始废弃，不再提供替代接口。

参数：

|参数项|描述| |–|–| |OHNativeWindow *window|一个OHNativeWindow的结构体实例的指针。| |uint32_t sequence|生产缓冲区的序列。| |int32_t size|OHHDRMetaData数组的大小。| |metaDate| 指向OHHDRMetaData数组的指针。|

返回：

|类型|说明| |–|–| |int32_t|返回值为0表示执行成功。|

OH_NativeWindow_NativeWindowSetMetaDataSet()

int32_t OH_NativeWindow_NativeWindowSetMetaDataSet(OHNativeWindow *window, uint32_t sequence, OHHDRMetadataKey key,int32_t size, const uint8_t *metaData)

描述

设置OHNativeWindow的元数据集。

系统能力： SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本： 9

废弃版本： 从API version 10开始废弃，不再提供替代接口。

参数：

|参数项|描述| |–|–| |OHNativeWindow *window|一个OHNativeWindow的结构体实例的指针。| |uint32_t sequence|生产缓冲区的序列。| |OHHDRMetadataKey key|枚举值OHHDRMetadataKey。| |int32_t size|uint8_t向量的大小。| |metaDate| 指向uint8_t向量的指针。|

返回：

|类型|说明| |–|–| |int32_t|返回值为0表示执行成功。|

OH_NativeWindow_NativeWindowSetTunnelHandle()

int32_t OH_NativeWindow_NativeWindowSetTunnelHandle(OHNativeWindow *window, const OHExtDataHandle *handle)

描述

设置OHNativeWindow的TunnelHandle。

系统能力： SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本： 9

废弃版本： 从API version 10开始废弃，不再提供替代接口。

参数：

|参数项|描述| |–|–| |OHNativeWindow *window|一个OHNativeWindow的结构体实例的指针。| |const OHExtDataHandle *handle|指向OHExtDataHandle的指针。|

返回：

|类型|说明| |–|–| |int32_t|返回值为0表示执行成功。|

OH_NativeWindow_NativeWindowAttachBuffer()

int32_t OH_NativeWindow_NativeWindowAttachBuffer(OHNativeWindow *window, OHNativeWindowBuffer *buffer)

描述

将OHNativeWindowBuffer添加进OHNativeWindow中。
本接口需要与OH_NativeWindow_NativeWindowDetachBuffer接口配合使用，否则会存在内存管理混乱问题。
本接口为非线程安全类型接口。

系统能力： SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本： 12

参数：

|参数项|描述| |–|–| |OHNativeWindow *window|一个OHNativeWindow的结构体实例的指针。| |OHNativeWindowBuffer *buffer|一个OHNativeWindowBuffer的结构体实例的指针。|

返回：

|类型|说明| |–|–| |int32_t|返回值为0表示执行成功，其他返回值可参考OHNativeErrorCode。|

OH_NativeWindow_NativeWindowDetachBuffer()

int32_t OH_NativeWindow_NativeWindowDetachBuffer(OHNativeWindow *window, OHNativeWindowBuffer *buffer)

描述

将OHNativeWindowBuffer从OHNativeWindow中分离。
本接口为非线程安全类型接口。

系统能力： SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本： 12

参数：

|参数项|描述| |–|–| |OHNativeWindow *window|一个OHNativeWindow的结构体实例的指针。| |OHNativeWindowBuffer *buffer|一个OHNativeWindowBuffer的结构体实例的指针。|

返回：

|类型|说明| |–|–| |int32_t|返回值为0表示执行成功，其他返回值可参考OHNativeErrorCode。|

OH_NativeWindow_GetSurfaceId()

int32_t OH_NativeWindow_GetSurfaceId(OHNativeWindow *window, uint64_t *surfaceId)

描述

通过OHNativeWindow获取对应的surfaceId。
本接口为非线程安全类型接口。

系统能力： SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本： 12

参数：

|参数项|描述| |–|–| |OHNativeWindow *window|一个OHNativeWindow的结构体实例的指针。| |uint64_t *surfaceId|一个surface对应ID的指针。|

返回：

|类型|说明| |–|–| |int32_t|返回值为0表示执行成功，其他返回值可参考OHNativeErrorCode。|

OH_NativeWindow_CreateNativeWindowFromSurfaceId()

int32_t OH_NativeWindow_CreateNativeWindowFromSurfaceId(uint64_t surfaceId, OHNativeWindow **window)

描述

通过surfaceId创建对应的OHNativeWindow。
本接口需要与OH_NativeWindow_DestroyNativeWindow接口配合使用，否则会存在内存泄露。
如果存在并发释放OHNativeWindow的情况，需要通过OH_NativeWindow_NativeObjectReference和OH_NativeWindow_NativeObjectUnreference对OHNativeWindow进行引用计数加一和减一。
通过surfaceId获取的surface需要是在本进程中创建的，不能跨进程获取surface。
本接口为非线程安全类型接口。

系统能力： SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本： 12

参数：

|参数项|描述| |–|–| |uint64_t surfaceId|一个surface对应的ID。| |OHNativeWindow **window|一个OHNativeWindow的结构体实例的二级指针。|

返回：

|类型|说明| |–|–| |int32_t|返回值为0表示执行成功，其他返回值可参考OHNativeErrorCode。|

OH_NativeWindow_NativeWindowSetScalingModeV2()

int32_t OH_NativeWindow_NativeWindowSetScalingModeV2(OHNativeWindow* window, OHScalingModeV2 scalingMode)

描述

设置OHNativeWindow的渲染缩放模式。
本接口为非线程安全类型接口。

系统能力： SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本： 12

参数：

|参数项|描述| |–|–| |OHNativeWindow* window|一个OHNativeWindow的结构体实例的指针。| |OHScalingModeV2 scalingMode|一个OHScalingModeV2类型的枚举值。|

返回：

|类型|说明| |–|–| |int32_t|返回值为0表示执行成功，其他返回值可参考OHNativeErrorCode。|

OH_NativeWindow_GetLastFlushedBufferV2()

int32_t OH_NativeWindow_GetLastFlushedBufferV2(OHNativeWindow *window, OHNativeWindowBuffer **buffer,int *fenceFd, float matrix[16])

描述

从OHNativeWindow获取上次送回到buffer队列中的OHNativeWindowBuffer,与OH_NativeWindow_GetLastFlushedBuffer的差异在于matrix不同。
本接口需要与OH_NativeWindow_NativeObjectUnreference接口配合使用，否则会存在内存泄露。
本接口为非线程安全类型接口。

系统能力： SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本： 12

参数：

|参数项|描述| |–|–| |OHNativeWindow *window|一个OHNativeWindow的结构体实例的指针。| |OHNativeWindowBuffer **buffer|一个OHNativeWindowBuffer结构体指针的指针。| |int *fenceFd|一个文件描述符的指针。| |matrix| 表示检索到的44变换矩阵。|

返回：

|类型|说明| |–|–| |int32_t|返回值为0表示执行成功，其他返回值可参考OHNativeErrorCode。|

OH_NativeWindow_SetBufferHold()

void OH_NativeWindow_SetBufferHold(OHNativeWindow *window)

描述

提前缓存一帧buffer，且缓存的这一帧延迟一帧上屏显示，以此抵消后续一次超长帧丢帧。
本接口为非线程安全类型接口。

系统能力： SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本： 12

参数：

|参数项|描述| |–|–| |OHNativeWindow *window|一个OHNativeWindow的结构体实例的指针。|

OH_NativeWindow_WriteToParcel()

int32_t OH_NativeWindow_WriteToParcel(OHNativeWindow *window, OHIPCParcel *parcel)

描述

将窗口对象写入IPC序列化对象中。
本接口为非线程安全类型接口。

系统能力： SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本： 12

参数：

|参数项|描述| |–|–| |OHNativeWindow *window|一个指向OHNativeWindow的结构体实例的指针。| |OHIPCParcel *parcel|一个指向OHIPCParcel的结构体实例的指针。|

返回：

|类型|说明| |–|–| |int32_t|返回值为0表示执行成功，其他返回值可参考OHNativeErrorCode。|

OH_NativeWindow_ReadFromParcel()

int32_t OH_NativeWindow_ReadFromParcel(OHIPCParcel *parcel, OHNativeWindow **window)

描述

从IPC序列化对象中读取窗口对象。
本接口为非线程安全类型接口。

系统能力： SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本： 12

参数：

|参数项|描述| |–|–| |OHIPCParcel *parcel|一个指向OHIPCParcel的结构体实例的指针。| |OHNativeWindow **window|一个指向OHNativeWindow的结构体实例的二级指针。|

返回：

|类型|说明| |–|–| |int32_t|返回值为0表示执行成功，其他返回值可参考OHNativeErrorCode。|

OH_NativeWindow_SetColorSpace()

int32_t OH_NativeWindow_SetColorSpace(OHNativeWindow *window, OH_NativeBuffer_ColorSpace colorSpace)

描述

为OHNativeWindow设置颜色空间属性。
本接口为非线程安全类型接口。

系统能力： SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本： 12

参数：

|参数项|描述| |–|–| |OHNativeWindow *window|一个指向OHNativeWindow的结构体实例的指针。| |OH_NativeBuffer_ColorSpace colorSpace|为OHNativeWindow设置的颜色空间，其值从OH_NativeBuffer_ColorSpace获取。|

返回：

|类型|说明| |–|–| |int32_t|返回值为0表示执行成功，其他返回值可参考OHNativeErrorCode。|

OH_NativeWindow_GetColorSpace()

int32_t OH_NativeWindow_GetColorSpace(OHNativeWindow *window, OH_NativeBuffer_ColorSpace *colorSpace)

描述

获取OHNativeWindow颜色空间属性。
本接口为非线程安全类型接口。

系统能力： SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本： 12

参数：

|参数项|描述| |–|–| |OHNativeWindow *window|一个指向OHNativeWindow的结构体实例的指针。| |OH_NativeBuffer_ColorSpace *colorSpace|为OHNativeWindow设置的颜色空间，其值从OH_NativeBuffer_ColorSpace获取。|

返回：

|类型|说明| |–|–| |int32_t|返回值为0表示执行成功，其他返回值可参考OHNativeErrorCode。|

OH_NativeWindow_SetMetadataValue()

int32_t OH_NativeWindow_SetMetadataValue(OHNativeWindow *window, OH_NativeBuffer_MetadataKey metadataKey,int32_t size, uint8_t *metadata)

描述

为OHNativeWindow设置元数据属性值。
本接口为非线程安全类型接口。

系统能力： SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本： 12

参数：

|参数项|描述| |–|–| |OHNativeWindow *window|一个指向OHNativeWindow的结构体实例的指针。| |OH_NativeBuffer_MetadataKey metadataKey|Window的元数据类型，其值从OH_NativeBuffer_MetadataKey获取。| |int32_t size|uint8_t向量的大小，其取值范围见OH_NativeBuffer_MetadataKey。| |metaDate| 指向uint8_t向量的指针。|

返回：

|类型|说明| |–|–| |int32_t|返回值为0表示执行成功，其他返回值可参考OHNativeErrorCode。|

OH_NativeWindow_GetMetadataValue()

int32_t OH_NativeWindow_GetMetadataValue(OHNativeWindow *window, OH_NativeBuffer_MetadataKey metadataKey,int32_t *size, uint8_t **metadata)

描述

获取OHNativeWindow元数据属性值。
本接口为非线程安全类型接口。

系统能力： SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本： 12

参数：

|参数项|描述| |–|–| |OHNativeWindow *window|一个指向OHNativeWindow的结构体实例的指针。| |OH_NativeBuffer_MetadataKey metadataKey|Window的元数据类型，其值从OH_NativeBuffer_MetadataKey获取。| |int32_t *size|uint8_t向量的大小，其取值范围见OH_NativeBuffer_MetadataKey。| |metaDate| 指向uint8_t向量的二级指针。|

返回：

|类型|说明| |–|–| |int32_t|返回值为0表示执行成功，其他返回值可参考OHNativeErrorCode。|

OH_NativeWindow_CleanCache()

int32_t OH_NativeWindow_CleanCache(OHNativeWindow *window)

描述

清理OHNativeWindow中的OHNativeWindowBuffer缓存。
使用该接口清理缓存前，需确保已通过OH_NativeWindow_NativeWindowRequestBuffer接口成功申请OHNativeWindowBuffer。
本接口为非线程安全类型接口。

系统能力： SystemCapability.Graphic.Graphic2D.NativeWindow

起始版本： 19

参数：

|参数项|描述| |–|–| |OHNativeWindow *window|一个指向OHNativeWindow的结构体实例的指针。|

返回：

|类型|说明| |–|–| |int32_t|返回值为0表示执行成功，其他返回值可参考OHNativeErrorCode。|

你可能感兴趣的鸿蒙文章

harmony 鸿蒙ArkGraphics 2D（方舟2D图形服务）

harmony 鸿蒙buffer_common.h

harmony 鸿蒙buffer_handle.h

harmony 鸿蒙BufferHandle

harmony 鸿蒙ColorSpacePrimaries

harmony 鸿蒙DisplaySoloist_ExpectedRateRange

harmony 鸿蒙drawing_bitmap.h

harmony 鸿蒙drawing_brush.h

harmony 鸿蒙drawing_canvas.h

harmony 鸿蒙drawing_color_filter.h

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